> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IDStorageQueueX1::EnqueueSetEvent

> IDStorageQueueX1::EnqueueSetEvent

# IDStorageQueueX1::EnqueueSetEvent

将 **SetEvent** 操作入队。

## Syntax

```cpp theme={null}
void EnqueueSetEvent(  
         HANDLE handle  
)  
```

### Parameters

*handle*\
类型：HANDLE

一个事件句柄。

### Return value

类型：void

## Remarks

当在其之前入队的所有请求全部完成后，指定的事件会被发出信号。该事件既可以是自动重置的，也可以是手动重置的。

调用此方法后，游戏线程可以按需等待该事件。如果在执行 set event 操作时该事件已经处于已发信号状态，且启用了 DSTORAGE\_DEBUG\_SHOW\_ERRORS，则调试器中会打印一条警告消息。

如果 `EnqueueSetEvent` 方法自上次提交以来填充了队列容量的一半，则在 `EnqueueSetEvent` 调用中会触发一次自动提交。

在大多数情况下，此方法只是向队列执行一次内存写入，因此所占用的 CPU 时间很少。但是，如果触发了自动提交，则会占用明显更多的 CPU 时间，包括一次内核模式切换以及在调用方线程中处理所有先前已提交的请求。

如果不希望发生自动提交，建议游戏使用容量足够大的队列，并在合适的时机手动调用 [Submit](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit)。

有关详细信息，请参阅 [DirectStorage 概述](/build/console-features/storage/directstorage/directstorage-overview) 中的“Notification”和“EnqueueStatus/EnqueueSignal/EnqueueSetEvent”几节。

## Requirements

**头文件：** dstorage\_xs.h

**库：** dstorage\_xs.lib

**受支持的平台：** XBOX Series 主机

## See also

[IDStorageQueueX::EnqueueStatus](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus)\
[IDStorageQueueX::EnqueueSignal](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal)\
[IDStorageQueueX](/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/reference/system/dstorage/dstorage_members)


## Related topics

- [IDStorageQueueX1](/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX1/idstoragequeuex1.md)
- [DirectStorage 概述](/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageQueueX::Submit](/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX2](/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX2/idstoragequeuex2.md)
- [IDStorageQueueX::EnqueueSignal](/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)