Skip to main content

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::EnqueueStatus
IDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage
Last modified on October 6, 2026