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 を含む) |