> ## 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 状态数组对象。

## Syntax

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

### Parameters

*capacity*\
类型：UINT32

指定该数组可容纳的状态条目数量。

*name*\
类型：PCSTR

状态数组的名称。用于调试。

*riid*\
类型：REFIID

指定 DirectStorage 状态接口，例如 `__uuidof(IDStorageStatusArrayX)`。

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

接收新创建的状态数组对象。

### Return value

类型：HRESULT

标准 HRESULT 错误代码。

## Remarks

DirectStorage 状态数组用于存储完成状态标志。若要将状态写入操作入队，请调用 [IDStorageQueueX::EnqueueStatus](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus)。

有关详细信息，请参阅 [DirectStorage 概述](/build/console-features/storage/directstorage/directstorage-overview) 中的“EnqueueStatus/EnqueueSignal”一节。

## Requirements

**头文件：** dstorage\_xs.h

**库：** dstorage\_xs.lib

**受支持的平台：** XBOX Series 主机

## See also

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


## Related topics

- [IDStorageQueueX::EnqueueStatus](/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuestatus.md)
- [IDStorageFactoryX::CreateQueue](/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_createqueue.md)
- [IDStorageFactoryX](/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX/idstoragefactoryx.md)
- [DirectStorage 概述](/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageFactoryX::SetDebugFlags](/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_setdebugflags.md)