KSPRIORITY 結構 (ks.h)

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

語法

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

成員

PriorityClass

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

PriorityClass Description
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