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

# IDStorageFactoryX::CreateStatusArray

> IDStorageFactoryX::CreateStatusArray

# IDStorageFactoryX::CreateStatusArray

建立 DirectStorage 狀態陣列物件。

## 語法

```cpp theme={null}
HRESULT CreateStatusArray(  
         UINT32 capacity,  
         PCSTR name,
         REFIID riid,  
         void **ppv  
)  
```

### 參數

*capacity*\
類型：UINT32

指定陣列可容納的狀態項目數目。

*name*\
類型：PCSTR

狀態陣列的名稱。用於偵錯。

*riid*\
類型：REFIID

指定 DirectStorage 狀態介面，例如 `__uuidof(IDStorageStatusArrayX)`。

*ppv*   \_COM\_Outptr\_\
類型：void \*\*

接收新建立的狀態陣列物件。

### 傳回值

類型：HRESULT

標準 HRESULT 錯誤碼。

## 備註

DirectStorage 狀態陣列會儲存完成狀態旗標。若要將狀態寫入加入佇列，請呼叫 [IDStorageQueueX::EnqueueStatus](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus)。

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

## 需求

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

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

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

## 另請參閱

[IDStorageFactoryX](/zh-TW/reference/system/dstorage/interfaces/IDStorageFactoryX/idstoragefactoryx)\
[DStorage](/zh-TW/reference/system/dstorage/dstorage_members)


## Related topics

- [IDStorageFactoryX::CreateStatusArray](/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_createstatusarray.md)
- [IDStorageQueueX::EnqueueStatus](/ja-jp/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)