KsPinRegisterIrpCompletionCallback 関数 (ks.h)
KsPinRegisterIrpCompletionCallback 関数は、指定されたピンのミニドライバー定義のコールバック ルーチンを登録します。 AVStream は、IRP が回路の周りのパスを完了し、IRP に関連付けられているフレームがリサイクルまたは廃止されようとしているときに、ミニドライバーによって提供されるルーチンを呼び出します。
構文
void KsPinRegisterIrpCompletionCallback(
[in] PKSPIN Pin,
[in] PFNKSPINIRPCOMPLETION IrpCompletion
);
パラメーター
[in] Pin
完了コールバックを登録する KSPIN 構造体へのポインター。
[in] IrpCompletion
このパラメーターは、IRP が回線のトラバーサルを完了し、リサイクルまたは廃止されようとしているときに呼び出される AVStrMiniPinIrpCompletion ルーチンのアドレスを提供します。
戻り値
なし
解説
ピンがKSSTATE_ACQUIREに入る前に、IRQL=PASSIVE_LEVEL で KsPinRegisterIrpCompletionCallback を呼び出す必要があります。 ピンの状態の詳細については、「 KSSTATE」を参照してください。
この関数は、ピン作成ディスパッチから頻繁に呼び出されます。 「KSPIN_DISPATCH」を参照してください。
KsPinRegisterIrpCompletionCallback は、IRP ソース ピンでのみ役立ち、通常はデータ ソース ピンで使用されます。 データ ソースピンの場合、IRP がピンに戻り、リサイクルされようとすると、コールバックが行われます。 ただし、データ シンク ピンの場合、コールバックは IRP 完了に直接関連付けされません。 AVStream は、IRP がリサイクルのために戻ったときにコールバックを行います。 この戻り値は、IRP が含まれているデータを使用する必要があるすべてのキューを通過するまで発生しません。 IRP ソース/シンク ピンとデータ ソース/シンク ピンの比較については、KSPIN_DESCRIPTOR構造体の DataFlow および Communication メンバーに関するページを参照してください。
KsPinRegisterIrpCompletionCallback は KsPinRegisterFrameReturnCallback とは大きく異なり、このルーチンではピンが新しいモードに配置されません。コールバック ルーチンを登録するだけです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |