> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://docs.xbox.com/reference/system/dstorage/structs/dstorage_queue_desc.md) 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](https://docs.xbox.com/build/console-features/storage/directstorage/directstorage-overview.md).

## Requirements

**Header:** dstorage\_xs.h

**Supported platforms:** XBOX Series consoles

## See also

[DStorage](https://docs.xbox.com/reference/system/dstorage/dstorage_members.md)


## Related topics

- [DSTORAGE_QUEUE_DESC](https://docs.xbox.com/reference/system/dstorage/structs/dstorage_queue_desc.md)
- [DSTORAGE_QUEUE_DESC1](https://docs.xbox.com/reference/system/dstorage/structs/dstorage_queue_desc1.md)
- [DStorage (API contents)](https://docs.xbox.com/reference/system/dstorage/dstorage_members.md)
- [DSTORAGE_PRIORITY_STATS data structure](https://docs.xbox.com/reference/system/dstorage/structs/dstorage_priority_stats.md)
- [DSTORAGE_STATS](https://docs.xbox.com/reference/system/dstorage/structs/dstorage_stats.md)