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

> DSTORAGE_PRIORITY

# DSTORAGE\_PRIORITY

Priority levels of a DirectStorage queue.

## Syntax

```cpp theme={null}
enum DSTORAGE_PRIORITY  : INT8  
{  
    DSTORAGE_PRIORITY_LOW = -1,  
    DSTORAGE_PRIORITY_NORMAL = 0,  
    DSTORAGE_PRIORITY_HIGH = 1,  
    DSTORAGE_PRIORITY_REALTIME = 2,  
    DSTORAGE_PRIORITY_FIRST = DSTORAGE_PRIORITY_LOW,  
    DSTORAGE_PRIORITY_LAST = DSTORAGE_PRIORITY_REALTIME,  
    DSTORAGE_PRIORITY_COUNT = 4  
}  
```

## Constants

| Constant                     | Description                                                                                        |
| ---------------------------- | -------------------------------------------------------------------------------------------------- |
| DSTORAGE\_PRIORITY\_LOW      | Lowest priority for a DirectStorage operation.                                                     |
| DSTORAGE\_PRIORITY\_NORMAL   | Majority of requests should be at this priority.                                                   |
| DSTORAGE\_PRIORITY\_HIGH     | Highest priority for a DirectStorage operation.                                                    |
| DSTORAGE\_PRIORITY\_REALTIME | Same priority as `DSTORAGE_PRIORITY_HIGH` but minimizes latency at the cost of increased CPU load. |
| DSTORAGE\_PRIORITY\_FIRST    | The lowest priority level; equal to `DSTORAGE_PRIORITY_LOW`.                                       |
| DSTORAGE\_PRIORITY\_LAST     | The highest priority level; equal to `DSTORAGE_PRIORITY_REALTIME`.                                 |
| DSTORAGE\_PRIORITY\_COUNT    | The number of priority levels.                                                                     |

## Remarks

This enumeration is used in the [DSTORAGE\_QUEUE\_DESC](/reference/system/dstorage/structs/dstorage_queue_desc) structure.

Priority is enforced by a weighted round-robin algorithm that is based on size of the requests. The difference between `DSTORAGE_PRIORITY_LOW` and `DSTORAGE_PRIORITY_NORMAL` is approximately an order of magnitude, as is the difference between `DSTORAGE_PRIORITY_NORMAL` and `DSTORAGE_PRIORITY_HIGH`.

All Win32 requests have normal priority (`DSTORAGE_PRIORITY_NORMAL`).

To iterate over the priority levels, use `DSTORAGE_PRIORITY_FIRST`, `DSTORAGE_PRIORITY_LAST`, and `DSTORAGE_PRIORITY_COUNT`.

For more information, see the "Priority" section of [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_DESC](/reference/system/dstorage/structs/dstorage_queue_desc.md)
- [DStorage](/reference/system/dstorage/dstorage_members.md)
- [DSTORAGE_QUEUE_DESC1](/reference/system/dstorage/structs/dstorage_queue_desc1.md)
- [DSTORAGE_PRIORITY_STATS](/reference/system/dstorage/structs/dstorage_priority_stats.md)
- [DSTORAGE_STATS](/reference/system/dstorage/structs/dstorage_stats.md)