KsPinRegisterIrpCompletionCallback 関数 (ks.h)

[アーティクル]
02/26/2024

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