PFNKSSTREAMPOINTER コールバック関数 (ks.h)

AVStream は、複製されたストリームポインターに関連付けられている IRP が取り消されたときにミニドライバーの AVStrMiniCancelCallback ルーチンを呼び出します。このルーチンは省略可能です。

構文

PFNKSSTREAMPOINTER Pfnksstreampointer;

void Pfnksstreampointer(
  [in] PKSSTREAM_POINTER StreamPointer
)
{...}

[in] StreamPointer

取り消された IRP に関連付けられている複製 KSSTREAM_POINTER へのポインター。 StreamPointer は、KsStreamPointerCloneの呼び出しによって作成されました。

何一つ

AVStrMiniCancelCallback 、ミニドライバーは、複製ポインターへのすべての参照を NULL 設定する必要があります。

さらに、ミニドライバーは、複製ポインターに関連するすべてのコンテキスト情報を削除し、取り消しについてハードウェアに通知する必要があります。

最後に、ミニドライバー KsStreamPointerDelete を呼び出して、複製とそれに関連付けられているコンテキストを削除する必要があります。ミニドライバーが複製を削除しない場合、IRP は参照カウントを保持し、完了せず、関連するアプリケーションがクラッシュする可能性があります。

AVStrMiniCancelCallback は、キューのスピンロックを保持して呼び出されるため、DISPATCH_LEVELで呼び出されます。したがって、コールバックルーチンは、ミューテックスを取得するキュー操作または呼び出し関数を実行できません。

要件	価値
サポートされる最小クライアント	Microsoft Windows XP 以降のオペレーティングシステムと DirectX 8.0 以降の DirectX バージョンで使用できます。
ターゲットプラットフォームの	デスクトップ
ヘッダー	ks.h (Ks.h を含む)