Skip to main content

IDStorageQueueX1::EnqueueSetEvent

SetEvent 操作入队。

Syntax

Parameters

handle
类型:HANDLE
一个事件句柄。

Return value

类型:void

Remarks

当在其之前入队的所有请求全部完成后,指定的事件会被发出信号。该事件既可以是自动重置的,也可以是手动重置的。 调用此方法后,游戏线程可以按需等待该事件。如果在执行 set event 操作时该事件已经处于已发信号状态,且启用了 DSTORAGE_DEBUG_SHOW_ERRORS,则调试器中会打印一条警告消息。 如果 EnqueueSetEvent 方法自上次提交以来填充了队列容量的一半,则在 EnqueueSetEvent 调用中会触发一次自动提交。 在大多数情况下,此方法只是向队列执行一次内存写入,因此所占用的 CPU 时间很少。但是,如果触发了自动提交,则会占用明显更多的 CPU 时间,包括一次内核模式切换以及在调用方线程中处理所有先前已提交的请求。 如果不希望发生自动提交,建议游戏使用容量足够大的队列,并在合适的时机手动调用 Submit 有关详细信息,请参阅 DirectStorage 概述 中的“Notification”和“EnqueueStatus/EnqueueSignal/EnqueueSetEvent”几节。

Requirements

头文件: dstorage_xs.h 库: dstorage_xs.lib 受支持的平台: XBOX Series 主机

See also

IDStorageQueueX::EnqueueStatus
IDStorageQueueX::EnqueueSignal
IDStorageQueueX
DStorage
最后修改于 2026年8月24日