IDStorageQueueX1::EnqueueSetEvent
將 SetEvent 作業加入佇列。語法
參數
handle類型:HANDLE 事件控制代碼。
傳回值
類型:void備註
當在指定事件之前加入佇列的所有要求都完成時,該事件就會收到訊號。 此事件可以是自動重設或手動重設。 呼叫此方法之後,遊戲執行緒可以視需要等候該事件。如果 在執行設定事件作業時,事件已處於訊號狀態,且已開啟 DSTORAGE_DEBUG_SHOW_ERRORS, 偵錯工具中就會列印警告訊息。 如果EnqueueSetEvent 方法在上次提交後填滿了佇列容量的一半,就會在
EnqueueSetEvent 呼叫中觸發自動提交。
在大多數情況下,此方法只會對佇列執行一次記憶體寫入,因此只需
極少的 CPU 時間即可完成。但是,如果觸發了自動提交,
就會耗用明顯更多的 CPU 時間,包括核心模式轉換,以及在呼叫端執行緒中
處理所有先前提交的要求。
如果不希望發生自動提交,建議遊戲使用容量夠大的佇列,
並在適當時機手動呼叫 Submit。
如需詳細資訊,請參閱 DirectStorage
概觀中的「Notification」和
「EnqueueStatus/EnqueueSignal/EnqueueSetEvent」章節。
需求
標頭: dstorage_xs.h 程式庫: dstorage_xs.lib 支援的平台: XBOX Series 主機另請參閱
IDStorageQueueX::EnqueueStatusIDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage
