> ## 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*\
類型：[DSTORAGE\_REQUEST](https://docs.xbox.com/zh-TW/reference/system/dstorage/structs/dstorage_request.md)

要加入佇列的讀取要求。

### 傳回值

類型：void

## 備註

此方法會將來自 *request* 的資料加入佇列。此方法一傳回，
[DSTORAGE\_REQUEST](https://docs.xbox.com/zh-TW/reference/system/dstorage/structs/dstorage_request.md) 結構即可
重複使用。

如果 `EnqueueRequest` 方法自上次提交以來填滿了佇列容量的一半，
它會在 `EnqueueRequest` 呼叫中觸發
自動提交。

在大多數情況下，此方法只會對佇列進行記憶體寫入，因此只需
極少的 CPU 時間即可完成。不過，如果觸發了自動提交，
就會耗用明顯更多的 CPU 時間，包括核心模式轉換，以及在呼叫端執行緒中
處理所有先前提交的要求。

如果不希望自動提交，建議遊戲使用容量夠大的
佇列，並在適當時機手動呼叫 [Submit](https://docs.xbox.com/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)。

如需詳細資訊，請參閱 [DirectStorage
概觀](https://docs.xbox.com/zh-TW/build/console-features/storage/directstorage/directstorage-overview.md)的「EnqueueRequest」一節。

## 需求

**標頭：** dstorage\_xs.h

**程式庫：** dstorage\_xs.lib

**支援的平台：** XBOX Series 主機

## 另請參閱

[IDStorageQueueX](https://docs.xbox.com/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)\
[DStorage](https://docs.xbox.com/zh-TW/reference/system/dstorage/dstorage_members.md)


## Related topics

- [DirectStorage 概觀](https://docs.xbox.com/zh-TW/build/console-features/storage/directstorage/directstorage-overview.md)
- [DSTORAGE_REQUEST](https://docs.xbox.com/zh-TW/reference/system/dstorage/structs/dstorage_request.md)
- [DSTORAGE_REQUEST_OPTIONS](https://docs.xbox.com/zh-TW/reference/system/dstorage/structs/dstorage_request_options.md)
- [Submit](https://docs.xbox.com/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_submit.md)
- [IDStorageQueueX (介面內容)](https://docs.xbox.com/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex.md)