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

Options of a DirectStorage queue.

## Syntax

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

### Members

*AutoSubmitDisabled*

Setting this value to 1 will disable the auto-submit feature of the DirectStorage Queue.

*Reserved*

Reserved. Must be zero.

## Remarks

This structure is used by the [IDStorageFactoryX2::CreateQueue1](/reference/system/dstorage/interfaces/IDStorageFactoryX2/methods/idstoragefactoryx_createqueue1) method and appears in the [DSTORAGE\_QUEUE\_INFO1](/reference/system/dstorage/structs/dstorage_queue_info1) structure.

*WARNING:* If you **disable** the auto-submit feature for a queue then its behaviour will change if the queue is at capacity. When attempting to Enqueue() a request to a full queue, the thread calling Enqueue() will ***STALL*** and become unresponsive until Submit() is called on the queue to free up more capacity. The Submit() call must be performed from a different thread to the Enqueue().

If this situation occurs, an error message will be displayed when the [DSTORAGE\_DEBUG\_SHOW\_ERRORS](/reference/system/dstorage/enums/dstorage_debug) flag is enabled.

For more information, see the "IDStorageQueueX2" section in [DirectStorage Overview](/build/console-features/storage/directstorage/directstorage-overview).

## Requirements

**Header:** dstorage\_xs.h

**Supported platforms:** XBOX Series consoles

## See also

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


## Related topics

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