共用方式為

KSPRIORITY 結構 （ks.h）

  • 發行項

KSPRIORITY 結構可用來指定優先順序，並搭配 KSPROPERTY_CONNECTION_PRIORITY 屬性使用。

語法

typedef struct {
  ULONG PriorityClass;
  ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;

成員

PriorityClass

指定從 1 到 0xFFFFFFFF 的數位，其中 1 是最不優先，0xFFFFFFFF是最高的優先順序。 零保留供日後使用。 設定類別值時，會使用0xFFFFFFFF來表示針腳所耗用資源的獨佔存取權。 下表列出可能的值。

PriorityClass 描述
KSPRIORITY_LOW 指定最低優先順序。
KSPRIORITY_NORMAL 指定一般優先順序。
KSPRIORITY_HIGH 指定提高優先順序。
KSPRIORITY_EXCLUSIVE 指定最高優先順序，這表示資源的獨佔存取權。

PrioritySubClass

指定範圍從 1 到 0xFFFFFFFF 的數位，其中 1 是類別內最不優先的數位，0xFFFFFFFF是最優先的數位。 零保留供日後使用。

言論

KSPRIORITY。PrioritySubClass 成員可讓用戶端設定釘選所取用資源的獨佔使用，並讓客戶端的針腳在該獨佔類別內優先使用這些資源。 針腳的初始優先順序是由連線要求所設定，通常是透過 KsCreatePin來執行，而且通常會KSPRIORITY_NORMAL，且子類別優先順序為 1。 從管理資源的任何元件配置共用資源時，針腳會使用這些優先順序做為參數。 當針腳上設定格式時，就會發生資源配置。

如果較高優先順序的用戶端移除資源導致篩選釘選失敗，則必須透過KSEVENT_CONNECTION_PRIORITY事件通知用戶端通知用戶端（假設客戶端已註冊此類型的事件通知）。

要求

要求 價值
標頭 ks.h （包括 Ks.h）

另請參閱

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin