Skip to main content
Queues a GPU-side wait, and returns immediately. A GPU-side wait is where the GPU waits until the specified fence reaches or exceeds the specified value.

Syntax

Parameters

pFence
Type: ID3D12Fence *
A pointer to the ID3D12Fence object. Value
Type: UINT64
The value that the command queue is waiting for the fence to reach or exceed. So when ID3D12Fence::GetCompletedValue is greater than or equal to Value, the wait is terminated.

Return value

Type: HRESULT This method returns one of the Direct3D 12 Return Codes.

Remarks

Because a wait is being queued, the API returns immediately. It’s the command queue that waits (during which time no work is executed) until the fence specified reaches the requested value. If you want to perform a CPU-side wait (where the calling thread blocks until a fence reaches a particular value), then you should use the ID3D12Fence::SetEventOnCompletion API in conjunction with WaitForSingleObject (or a similar API).

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

ID3D12CommandQueue Multi-engine synchronization
Last modified on August 20, 2026