> ## 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.

# EnqueueRequest

> IDStorageQueueX::EnqueueRequest

# IDStorageQueueX::EnqueueRequest

読み取り要求をキューに入れます。

## 構文

```cpp theme={null}
void EnqueueRequest(  
         const DSTORAGE_REQUEST *request  
)  
```

### パラメーター

*request*\
Type: [DSTORAGE\_REQUEST](https://docs.xbox.com/ja-jp/reference/system/dstorage/structs/dstorage_request.md)

キューに入れる読み取り要求。

### 戻り値

Type: void

## 解説

このメソッドは *request* のデータをキューに入れます。
[DSTORAGE\_REQUEST](https://docs.xbox.com/ja-jp/reference/system/dstorage/structs/dstorage_request.md) 構造体は、メソッドが戻ったらすぐに再利用できます。

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

ほとんどの場合、このメソッドは単にキューへのメモリ書き込みを行うだけであるため、完了までにかかる 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) の「EnqueueRequest」セクションを参照してください。

## 要件

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

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

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

## 関連項目

[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)
- [DSTORAGE_REQUEST_OPTIONS](https://docs.xbox.com/ja-jp/reference/system/dstorage/structs/dstorage_request_options.md)
- [DSTORAGE_REQUEST](https://docs.xbox.com/ja-jp/reference/system/dstorage/structs/dstorage_request.md)
- [Submit](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)
