SDL_MapGPUTransferBuffer - Man Page

Maps a transfer buffer into application address space.

Header File

Defined in SDL3/SDL_gpu.h

Synopsis

#include "SDL3/SDL.h"

void* SDL_MapGPUTransferBuffer(
    SDL_GPUDevice *device,
    SDL_GPUTransferBuffer *transfer_buffer,
    bool cycle);

Description

You must unmap the transfer buffer before encoding upload commands. The memory is owned by the graphics driver - do NOT call SDL_free () on the returned pointer.

Function Parameters

device

a GPU context.

transfer_buffer

a transfer buffer.

cycle

if true, cycles the transfer buffer if it is already bound.

Return Value

Returns the address of the mapped transfer buffer memory, or NULL on failure; call SDL_GetError () for more information.

Availability

This function is available since SDL 3.2.0.

Referenced By

SDL_GPUTransferBuffer.3type(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS