IDStorageQueueX1::EnqueueSetEvent
SetEvent 操作をキューに入れます。構文
パラメーター
handleType: HANDLE イベント ハンドル。
戻り値
Type: 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