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

> DSTORAGE_QUEUE_OPTIONS

# DSTORAGE\_QUEUE\_OPTIONS

DirectStorage 队列的选项。

## Syntax

```cpp theme={null}
union DSTORAGE_QUEUE_OPTIONS {
    struct {
        UINT64 AutoSubmitDisabled : 1;
        UINT64 Reserved : 63;  
    };
    UINT64 AsUINT64;
};
```

### Members

*AutoSubmitDisabled*

将此值设为 1 会禁用 DirectStorage 队列的自动提交功能。

*Reserved*

保留。必须为零。

## Remarks

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

*警告：* 如果 **禁用** 某个队列的自动提交功能，那么当该队列达到容量上限时其行为会发生变化。尝试对已满队列调用 Enqueue() 时，调用 Enqueue() 的线程将会 ***停顿*** 并变得无响应，直到在该队列上调用 Submit() 释放出更多容量。Submit() 调用必须在与 Enqueue() 不同的线程中执行。

如果发生这种情况，当启用了 [DSTORAGE\_DEBUG\_SHOW\_ERRORS](/reference/system/dstorage/enums/dstorage_debug) 标志时，会显示一条错误消息。

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

## Requirements

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

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

## See also

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


## Related topics

- [DSTORAGE_QUEUE_DESC1](/zh-CN/reference/system/dstorage/structs/dstorage_queue_desc1.md)
- [DStorage](/zh-CN/reference/system/dstorage/dstorage_members.md)
- [DSTORAGE_REQUEST_OPTIONS](/zh-CN/reference/system/dstorage/structs/dstorage_request_options.md)
- [DSTORAGE_QUEUE_DESC](/zh-CN/reference/system/dstorage/structs/dstorage_queue_desc.md)
- [DSTORAGE_QUEUE_INFO](/zh-CN/reference/system/dstorage/structs/dstorage_queue_info.md)