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

# EnqueueSetEvent

> IDStorageQueueX1::EnqueueSetEvent

# IDStorageQueueX1::EnqueueSetEvent

**SetEvent** 操作をキューに入れます。

## 構文

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

### パラメーター

*handle*\
Type: HANDLE

イベント ハンドル。

### 戻り値

Type: void

## 解説

指定されたイベントは、その前にキューに入れられたすべての要求が完了するとシグナルされます。
イベントは、自動リセットまたは手動リセットのいずれかです。

このメソッドを呼び出した後、タイトルのスレッドは必要に応じてイベントを待機できます。セット イベント操作が発生する時点でイベントが既にシグナル状態である場合、DSTORAGE\_DEBUG\_SHOW\_ERRORS が
有効になっていれば、デバッガーに警告メッセージが表示されます。

`EnqueueSetEvent` メソッドが前回の送信以降にキュー容量の半分を満たした場合、
`EnqueueSetEvent` 呼び出しの一部として自動送信がトリガーされます。

ほとんどの場合、このメソッドは単にキューへのメモリ書き込みを行うだけであるため、完了までにかかる CPU 時間はごくわずかです。ただし、自動送信がトリガーされた場合は、カーネル モードへの遷移や、以前に送信されたすべての要求を呼び出し元スレッドで処理することを含み、大幅に多くの CPU 時間を要します。

自動送信を避けたい場合は、十分な容量のキューを使用し、適切なタイミングで手動で [Submit](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md) を呼び出すことをお勧めします。

詳細については、[DirectStorage の概要](https://docs.xbox.com/ja-jp/build/console-features/storage/directstorage/directstorage-overview.md) の「Notification」および
「EnqueueStatus/EnqueueSignal/EnqueueSetEvent」セクションを参照してください。

## 要件

**ヘッダー:** dstorage\_xs.h

**ライブラリ:** dstorage\_xs.lib

**サポートされているプラットフォーム:** XBOX Series 本体

## 関連項目

[IDStorageQueueX::EnqueueStatus](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)\
[IDStorageQueueX::EnqueueSignal](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)\
[IDStorageQueueX](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)\
[DStorage](https://docs.xbox.com/ja-jp/reference/system/dstorage/dstorage_members.md)


## Related topics

- [DirectStorage の概要](https://docs.xbox.com/ja-jp/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageQueueX1 (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX1/idstoragequeuex1.md)
- [Submit](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [EnqueueSignal](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)
- [EnqueueStatus](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
