跳轉到主要內容
指定當柵欄達到特定值時所引發的事件。

語法

參數

Value
類型:UINT64
要發出事件訊號時的柵欄值。 hEvent
類型:HANDLE
事件物件的控制代碼。

傳回值

類型:HRESULT 如果核心元件沒有足夠的記憶體可將事件儲存在清單中,此方法會傳回 E_OUTOFMEMORY。如需其他可能的傳回值,請參閱 Direct3D 12 傳回碼。

備註

若要在觸發事件之前指定多個柵欄,請參閱 SetEventOnMultipleFenceCompletion。 如果 hEvent 是 null 控制代碼,則在達到指定的柵欄值之前,此 API 不會傳回。 此方法可以安全地同時從多個執行緒呼叫。

範例

D3D12Multithreading 範例使用 ID3D12Fence::SetEventOnCompletion 的方式如下:
請參閱 Direct3D 12 參考中的範例程式碼。

需求

標頭: d3d12_xs.h 或 d3d12_x.h
程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台: XBOX Series 主機與 XBOX One 系列

另請參閱

ID3D12Fence 多引擎同步處理
最後修改於 2026年10月6日