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 と通信 メンバー を参照してください。
KsPinRegisterIrpCompletionCallback は、このルーチンがピンを新しいモードに配置しないという点で、KsPinRegisterFrameReturnCallback と大きく異なります。コールバック ルーチンを登録するだけです。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ks.h (Ks.h を含む) |
| ライブラリ | Ks.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
KSPIN を する
KsPinRegisterFrameReturnCallback の