KSPRIORITY 構造体 (ks.h)

KSPRIORITY 構造体は優先順位を指定するために使用され、KSPROPERTY_CONNECTION_PRIORITY プロパティと共に使用されます。

構文

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

メンバーズ

PriorityClass

1 から 0xFFFFFFFF までの範囲の数値を指定します。1 は最も優先順位が低く、0xFFFFFFFFが最も高い優先順位です。 ゼロは将来使用するために予約されています。 クラス値を設定する場合、0xFFFFFFFFは、ピンによって使用されるリソースへの排他的アクセスを示すために使用されます。 使用可能な値を次の表に示します。

PrioritySubClass

1 から 0xFFFFFFFF までの範囲の数値を指定します。1 はクラス内で最も優先順位が最も低く、0xFFFFFFFFが最も優先順位が高くなります。 ゼロは将来使用するために予約されています。

備考

KSPRIORITY。PrioritySubClass メンバーを使用すると、クライアントは、ピンによって消費されるリソースの排他的な使用を設定し、その排他的クラス内のクライアントのピンによってそれらのリソースの使用に優先順位を付けることもできます。 ピンの初期優先度は、通常、KsCreatePin を介して実行される接続要求によって設定され、通常はKSPRIORITY_NORMALされ、サブクラスの優先順位は 1 です。 ピンは、リソースを管理するコンポーネントから共有リソースを割り当てるときに、これらの優先順位をパラメーターとして使用します。 リソースの割り当ては、ピンに書式が設定されている場合に発生します。

優先順位の高いクライアントによるリソースの削除によってフィルター ピンが失敗する場合は、クライアントに KSEVENT_CONNECTION_PRIORITY イベントを通じて通知する必要があります (クライアントがこの種類のイベント通知に登録されている場合)。

必要条件

関連項目

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin