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

# DSTORAGE_QUEUE_DESC1

> DSTORAGE_QUEUE_DESC1

# DSTORAGE\_QUEUE\_DESC1

DirectStorage 队列的属性。

## Syntax

```cpp theme={null}
typedef struct DSTORAGE_QUEUE_DESC1 {  
    DSTORAGE_REQUEST_SOURCE_TYPE SourceType;  
    UINT16 Capacity;  
    DSTORAGE_PRIORITY Priority;  
    const CHAR *Name;
    DSTORAGE_QUEUE_OPTIONS Options;  
} DSTORAGE_QUEUE_DESC1  
```

### Members

*SourceType*\
类型：[DSTORAGE\_REQUEST\_SOURCE\_TYPE](/reference/system/dstorage/enums/dstorage_request_source_type)

队列可接受的请求源类型。

*Capacity*\
类型：UINT16

该队列可容纳的最大请求数。此值必须介于 `DSTORAGE_MIN_QUEUE_CAPACITY` 和 `DSTORAGE_MAX_QUEUE_CAPACITY` 的值之间。

*Priority*\
类型：[DSTORAGE\_PRIORITY](/reference/system/dstorage/enums/dstorage_priority)

此队列中请求的优先级。

*Name*\
类型：const CHAR \*

队列的名称。

*Options*
类型：[DSTORAGE\_QUEUE\_OPTIONS](/reference/system/dstorage/structs/dstorage_queue_options)

与此队列关联的选项。

## Remarks

此结构由 [IDStorageFactoryX::CreateQueue1](/reference/system/dstorage/interfaces/IDStorageFactoryX2/methods/idstoragefactoryx_createqueue1) 方法使用，并出现在 [DSTORAGE\_QUEUE\_INFO1](/reference/system/dstorage/structs/dstorage_queue_info1) 结构中。

*Name* 成员是可选的，用于调试。

options 结构提供禁用 DirectStorage 队列自动提交功能的能力。

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

## Requirements

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

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

## See also

[DStorage](/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_QUEUE_INFO1](/zh-CN/reference/system/dstorage/structs/dstorage_queue_info1.md)
- [IDStorageQueueX2::Query1](/zh-CN/reference/system/dstorage/interfaces/IDStorageQueueX2/methods/idstoragequeuex_query1.md)
- [DStorage](/zh-CN/reference/system/dstorage/dstorage_members.md)
- [DirectStorage 概述](/zh-CN/build/console-features/storage/directstorage/directstorage-overview.md)
- [IDStorageFactoryX2::CreateQueue1](/zh-CN/reference/system/dstorage/interfaces/IDStorageFactoryX2/methods/idstoragefactoryx_createqueue1.md)
