> ## 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 佇列的選項。

## 語法

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

### 成員

*AutoSubmitDisabled*

將此值設定為 1 會停用 DirectStorage 佇列的自動提交功能。

*Reserved*

保留。必須為零。

## 備註

此結構由 [IDStorageFactoryX2::CreateQueue1](/zh-TW/reference/system/dstorage/interfaces/IDStorageFactoryX2/methods/idstoragefactoryx_createqueue1) 方法使用，並出現在 [DSTORAGE\_QUEUE\_INFO1](/zh-TW/reference/system/dstorage/structs/dstorage_queue_info1) 結構中。

*警告：* 如果您為佇列**停用**自動提交功能，則當佇列已達容量上限時，其行為將會改變。嘗試將要求 Enqueue() 至已滿的佇列時，呼叫 Enqueue() 的執行緒將會***停滯***並失去回應，直到在該佇列上呼叫 Submit() 以釋放更多容量為止。Submit() 呼叫必須從與 Enqueue() 不同的執行緒執行。

如果發生這種情況，當啟用 [DSTORAGE\_DEBUG\_SHOW\_ERRORS](/zh-TW/reference/system/dstorage/enums/dstorage_debug) 旗標時，將會顯示錯誤訊息。

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

## 需求

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

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

## 另請參閱

[DStorage](/zh-TW/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_QUEUE_OPTIONS](/reference/system/dstorage/structs/dstorage_queue_options.md)
- [DSTORAGE_QUEUE_DESC1](/reference/system/dstorage/structs/dstorage_queue_desc1.md)
- [DStorage](/reference/system/dstorage/dstorage_members.md)