StreamClassCallAtNewPriority 関数 (strmini.h)
StreamClassCallAtNewPriority ルーチンは、別の優先順位で呼び出されるルーチンをスケジュールします。
構文
VOID STREAMAPI StreamClassCallAtNewPriority(
[in, optional] PHW_STREAM_OBJECT StreamObject,
[in] PVOID HwDeviceExtension,
[in] STREAM_PRIORITY Priority,
[in] PHW_PRIORITY_ROUTINE PriorityRoutine,
[in] PVOID Context
);
パラメーター
[in, optional] StreamObject
ストリームを指定するHW_STREAM_OBJECT構造体へのポインターがルーチンに関連付けられているか、ルーチンがデバイス全体に関連付けられている場合は NULL を します。 ストリームごとに 1 つのルーチンしか存在できません。また、デバイス用のルーチンは 1 つだけです。 このパラメーターは省略可能です。
[in] HwDeviceExtension
ミニドライバーのデバイス拡張機能へのポインター。 ミニドライバーは、StreamClassRegisterMinidriver を介して自身を登録するときに渡す HW_INITIALIZATION_DATA 構造体内のこのバッファーのサイズ指定します。 その後、クラス ドライバーは、ミニドライバーに渡される HW_STREAM_REQUEST_BLOCK、HW_STREAM_OBJECT、HW_TIME_CONTEXT、および PORT_CONFIGURATION_INFORMATION 構造体の HwDeviceExtension メンバー内のバッファーへのポインターを渡します。
[in] Priority
次の表に示す値のいずれかを指定します。
優先権 | 使い |
---|---|
高い | ストリーム クラス ドライバーは、ミニドライバーの StrMiniXxx コールバックと同じ優先順位でルーチンを呼び出します。 ルーチンをミニドライバーの割り込みサービス ルーチンと同期する必要がある場合を除き、この設定を使用しないでください。 |
派遣 | ストリーム クラス ドライバーは、DISPATCH_LEVELでルーチンを呼び出します。 ルーチンの完了に 1 ミリ秒未満かかる場合は、この優先順位を使用します。 |
低い | ストリーム クラス ドライバーは、PASSIVE_LEVELでルーチンを呼び出します。 ルーチンの完了に 1 ミリ秒未満かかる場合は、この優先順位を使用します。 |
LowToHigh | 低優先度で呼び出されたスレッドが高優先度に戻り、他のストリーム クラス ドライバー サービスを呼び出すことができるようにするために使用されます。 |
[in] PriorityRoutine
ミニドライバーが指定した StrMiniPriorityRoutine へのポインター、指定された優先度レベルで呼び出されます。
[in] Context
PriorityRoutineに渡すパラメーターを指定します。
戻り値
何一つ
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | strmini.h (Strmini.h を含む) |
ライブラリ | Stream.lib |
IRQL | (「パラメーター」セクションを参照) |