SDL_SubmitGPUCommandBufferAndAcquireFence
Submits a command buffer so its commands can be processed on the GPU, and acquires a fence associated with the command buffer.
Synopsis
#include <SDL3/SDL_gpu.h> SDL_GPUFence * SDL_SubmitGPUCommandBufferAndAcquireFence( SDL_GPUCommandBuffer *command_buffer);
Description
You must release this fence when it is no longer needed or it will cause a leak. It is invalid to use the command buffer after this is called.
This must be called from the thread the command buffer was acquired on.
All commands in the submission are guaranteed to begin executing before any command in a subsequent submission begins executing.
Function Parameters
- command_buffer
a command buffer.
Return Value
Returns a fence associated with the command buffer, or NULL on failure; call SDL_GetError() for more information.
Availability
This function is available since SDL 3.2.0.
See Also
SDL_AcquireGPUCommandBuffer(3), SDL_WaitAndAcquireGPUSwapchainTexture(3), SDL_AcquireGPUSwapchainTexture(3), SDL_SubmitGPUCommandBuffer(3), SDL_ReleaseGPUFence(3)
Referenced By
SDL_AcquireGPUCommandBuffer(3), SDL_AcquireGPUSwapchainTexture(3), SDL_GPUCommandBuffer.3type(3), SDL_GPUFence.3type(3), SDL_QueryGPUFence(3), SDL_ReleaseGPUFence(3), SDL_SubmitGPUCommandBuffer(3), SDL_WaitAndAcquireGPUSwapchainTexture(3), SDL_WaitForGPUFences(3).