> ## 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](/zh-TW/reference/system/dstorage/structs/dstorage_queue_desc) 結構。

優先順序是由以要求大小為基礎的加權循環配置資源 (weighted round-robin) 演算法強制執行。`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 概觀](/zh-TW/build/console-features/storage/directstorage/directstorage-overview)的「Priority」一節。

## 需求

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

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

## 另請參閱

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


## Related topics

- [DSTORAGE_PRIORITY](/reference/system/dstorage/enums/dstorage_priority.md)
- [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)