KSPRIORITY 構造体 (ks.h)

  • [アーティクル]

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

構文

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

メンバー

PriorityClass

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

PriorityClass 説明
KSPRIORITY_LOW 最も低い優先度を指定します。
KSPRIORITY_NORMAL 通常の優先度を指定します。
KSPRIORITY_HIGH 昇格された優先度を指定します。
KSPRIORITY_EXCLUSIVE リソースへの排他アクセスを意味する最も高い優先度を指定します。

PrioritySubClass

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

注釈

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

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

要件

要件 値
Header ks.h (Ks.h を含む)

こちらもご覧ください

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin