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

# IDStorageQueueX::EnqueueRequest

> IDStorageQueueX::EnqueueRequest

# IDStorageQueueX::EnqueueRequest

將讀取要求加入佇列。

## 語法

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

### 參數

*request*\
類型：[DSTORAGE\_REQUEST](/zh-TW/reference/system/dstorage/structs/dstorage_request)

要加入佇列的讀取要求。

### 傳回值

類型：void

## 備註

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

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

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

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

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

## 需求

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

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

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

## 另請參閱

[IDStorageQueueX](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/zh-TW/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_REQUEST_OPTIONS](/zh-TW/reference/system/dstorage/structs/dstorage_request_options.md)
- [DSTORAGE_REQUEST](/zh-TW/reference/system/dstorage/structs/dstorage_request.md)
- [IDStorageQueueX::EnqueueSignal](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)
- [IDStorageQueueX::EnqueueStatus](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [IDStorageQueueX::CancelRequestsWithTag](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_cancelrequestswithtag.md)