次の方法で共有


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 メンバーに関するページを参照してください。

KsPinRegisterIrpCompletionCallbackKsPinRegisterFrameReturnCallback とは大きく異なり、このルーチンではピンが新しいモードに配置されません。コールバック ルーチンを登録するだけです。

要件

要件
サポートされている最小のクライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
Library Ks.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

AVStrMiniPinCreate

AVStrMiniPinIrpCompletion

KSPIN

KSPIN_DISPATCH

KSSTATE

KsPinRegisterFrameReturnCallback