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

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

構文

PFNKSSTREAMPOINTER Pfnksstreampointer;

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

パラメーター

[in] StreamPointer

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

戻り値

なし

解説

ミニドライバーは、KsStreamPointerCloneCancelCallback パラメーターでこのルーチンのアドレスを指定します。

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

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

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

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

要件

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

こちらもご覧ください

KSSTREAM_POINTER

KsStreamPointerClone

KsStreamPointerDelete