> ## 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::EnqueueStatus

> IDStorageQueueX::EnqueueStatus

# IDStorageQueueX::EnqueueStatus

將狀態寫入加入佇列。

## 語法

```cpp theme={null}
void EnqueueStatus(  
         IDStorageStatusArrayX *statusArray,  
         UINT32 index  
)  
```

### 參數

*statusArray*\
類型：IDStorageStatusArrayX

[IDStorageStatusArrayX](/zh-TW/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx) 物件。

*index*\
類型：UINT32

`IDStorageStatusArrayX` 物件中要接收狀態之狀態項目的索引。

### 傳回值

類型：void

## 備註

當在其之前加入佇列的所有要求都完成時，狀態陣列就會收到訊號。

呼叫此方法之後，遊戲執行緒可以視需要輪詢 `IDStorageStatusArrayX`
物件。(在呼叫此方法之前，狀態的狀態是未定義的。) 如果自上一個狀態項目以來發生任何失敗，加入佇列之狀態項目的 *HResult*
會儲存第一個失敗要求的失敗碼。

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

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

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

如需詳細資訊，請參閱 [DirectStorage
概觀](/zh-TW/build/console-features/storage/directstorage/directstorage-overview)中的「Notification」和
「EnqueueStatus/EnqueueSignal/EnqueueSetEvent」章節。

## 需求

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

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

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

## 另請參閱

[IDStorageFactoryX::CreateStatusArray](/zh-TW/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_createstatusarray)\
[IDStorageQueueX::EnqueueSignal](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal)\
[IDStorageQueueX](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/idstoragequeuex)\
[DStorage](/zh-TW/reference/system/dstorage/dstorage_members)


## Related topics

- [IDStorageQueueX::EnqueueStatus](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [IDStorageQueueX::EnqueueSignal](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuesignal.md)