devela::_dep::sdl3::sys::gpu

Function SDL_CreateGPUTransferBuffer

pub unsafe extern "C" fn SDL_CreateGPUTransferBuffer(
    device: *mut SDL_GPUDevice,
    createinfo: *const SDL_GPUTransferBufferCreateInfo,
) -> *mut SDL_GPUTransferBuffer
Available on crate feature dep_sdl3 only.
Expand description

Creates a transfer buffer to be used when uploading to or downloading from graphics resources.

Download buffers can be particularly expensive to create, so it is good practice to reuse them if data will be downloaded regularly.

There are optional properties that can be provided through props. These are the supported properties:

§Parameters

  • device: a GPU Context.
  • createinfo: a struct describing the state of the transfer buffer to create.

§Return value

Returns a transfer buffer on success, or NULL on failure; call [SDL_GetError()] for more information.

§Availability

This function is available since SDL 3.2.0.

§See also