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

DirectStorage 队列的优先级。

## 语法

```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  
}  
```

## 常量

| 常量                           | 说明                                                       |
| ---------------------------- | -------------------------------------------------------- |
| DSTORAGE\_PRIORITY\_LOW      | DirectStorage 操作的最低优先级。                                  |
| DSTORAGE\_PRIORITY\_NORMAL   | 大多数请求应使用此优先级。                                            |
| DSTORAGE\_PRIORITY\_HIGH     | DirectStorage 操作的最高优先级。                                  |
| DSTORAGE\_PRIORITY\_REALTIME | 与 `DSTORAGE_PRIORITY_HIGH` 具有相同的优先级，但通过增加 CPU 负载来尽量减小延迟。 |
| DSTORAGE\_PRIORITY\_FIRST    | 最低优先级；等同于 `DSTORAGE_PRIORITY_LOW`。                       |
| DSTORAGE\_PRIORITY\_LAST     | 最高优先级；等同于 `DSTORAGE_PRIORITY_REALTIME`。                  |
| DSTORAGE\_PRIORITY\_COUNT    | 优先级的数量。                                                  |

## 备注

此枚举用于 [DSTORAGE\_QUEUE\_DESC](/reference/system/dstorage/structs/dstorage_queue_desc) 结构体。

优先级通过基于请求大小的加权轮询算法来强制执行。`DSTORAGE_PRIORITY_LOW` 和 `DSTORAGE_PRIORITY_NORMAL` 之间大约相差一个数量级，`DSTORAGE_PRIORITY_NORMAL` 和 `DSTORAGE_PRIORITY_HIGH` 之间也是如此。

所有 Win32 请求都具有普通优先级 (`DSTORAGE_PRIORITY_NORMAL`)。

若要遍历优先级，请使用 `DSTORAGE_PRIORITY_FIRST`、`DSTORAGE_PRIORITY_LAST` 和 `DSTORAGE_PRIORITY_COUNT`。

有关详细信息，请参阅 [DirectStorage 概述](/build/console-features/storage/directstorage/directstorage-overview)中的“优先级”部分。

## 要求

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

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

## 另请参阅

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


## Related topics

- [DSTORAGE_QUEUE_DESC](/zh-CN/reference/system/dstorage/structs/dstorage_queue_desc.md)
- [DStorage](/zh-CN/reference/system/dstorage/dstorage_members.md)
- [DSTORAGE_QUEUE_DESC1](/zh-CN/reference/system/dstorage/structs/dstorage_queue_desc1.md)
- [DSTORAGE_PRIORITY_STATS](/zh-CN/reference/system/dstorage/structs/dstorage_priority_stats.md)
- [DSTORAGE_STATS](/zh-CN/reference/system/dstorage/structs/dstorage_stats.md)