gdk: Render/GPU can call SuspendX, document when to call SuspendComplete

This commit is contained in:
Ethan Lee
2026-02-25 09:20:25 -05:00
parent 49a8b4229b
commit 5770e013c2
4 changed files with 76 additions and 4 deletions

View File

@@ -664,6 +664,13 @@ extern SDL_DECLSPEC void SDLCALL SDL_UnregisterApp(void);
/**
* Callback from the application to let the suspend continue.
*
* When using SDL_Render or SDL_GPU, this function should be called _after_
* creating the `SDL_Renderer` or `SDL_GPUDevice`; this allows the timing of the
* D3D12 command queue suspension to execute in the correct order.
*
* If you're writing your own D3D12 renderer, this should be called after
* calling `ID3D12CommandQueue::SuspendX`.
*
* This function is only needed for Xbox GDK support; all other platforms will
* do nothing and set an "unsupported" error message.
*