ID3D12Fence

フェンスを表します。フェンスは、CPU と 1 つ以上の GPU の同期に使用されるオブジェクトです。(ID3D12Fence)

フェンスの現在の値を取得します。(ID3D12Fence.GetCompletedValue)

型: UINT64

フェンスの現在の値を返します。デバイスが削除されている場合、戻り値は UINT64_MAX になります。

フェンスが特定の値に達したときに発火させるイベントを指定します。(ID3D12Fence.SetEventOnCompletion)

型: HRESULT

カーネルコンポーネントがイベントをリストに格納するための十分なメモリを持たない場合、このメソッドは E_OUTOFMEMORY を返します。その他の戻り値については、Direct3D 12 のリターンコードを参照してください。

イベントが発生する前に複数のフェンスを指定するには、SetEventOnMultipleFenceCompletion を参照してください。

hEvent が null ハンドルの場合、この API は指定されたフェンス値に達するまで戻りません。

このメソッドは、複数のスレッドから同時に安全に呼び出すことができます。

例

D3D12Multithreading サンプルでは、ID3D12Fence::SetEventOnCompletion を次のように使用しています。

// Wait for the command list to execute; we are reusing the same command 
// list in our main loop but for now, we just want to wait for setup to 
// complete before continuing.

// Signal and increment the fence value.
const UINT64 fenceToWaitFor = m_fenceValue;
ThrowIfFailed(m_commandQueue->Signal(m_fence.Get(), fenceToWaitFor));
m_fenceValue++;

// Wait until the fence is completed.
ThrowIfFailed(m_fence->SetEventOnCompletion(fenceToWaitFor, m_fenceEvent));
WaitForSingleObject(m_fenceEvent, INFINITE);

Direct3D 12 リファレンスのサンプルコードを参照してください。

フェンスを指定した値に設定します。

型: HRESULT

このメソッドは、Direct3D 12 のリターンコードのいずれかを返します。

CPU 側からフェンス値を設定するには、このメソッドを使用します。GPU 側からフェンスを設定するには、ID3D12CommandQueue::Signal を使用します。