PFNKSSTREAMPOINTER コールバック関数 (ks.h)
AVStream は、複製されたストリーム ポインターに関連付けられている IRP が取り消されたときに、ミニドライバーの AVStrMiniCancelCallback ルーチンを呼び出します。 このルーチンは省略可能です。
構文
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
パラメーター
[in] StreamPointer
取り消された IRP に関連付けられている複製 KSSTREAM_POINTER へのポインター。 StreamPointer は KsStreamPointerClone の呼び出しによって作成されました。
戻り値
なし
解説
ミニドライバーは、KsStreamPointerClone の CancelCallback パラメーターでこのルーチンのアドレスを指定します。
AVStrMiniCancelCallback では、ミニドライバーは複製ポインターへのすべての参照を NULL に設定する必要があります。
さらに、ミニドライバーは、複製ポインターに関連するすべてのコンテキスト情報を削除し、取り消しについてハードウェアに通知する必要があります。
最後に、ミニドライバーは KsStreamPointerDelete を呼び出して、複製とそれに関連付けられているコンテキストを削除する必要があります。 ミニドライバーが複製を削除しない場合、IRP は参照カウントを保持し、完了せず、関連するアプリケーションがクラッシュする可能性があります。
AVStrMiniCancelCallback は、キューのスピン ロックを保持して呼び出されるため、DISPATCH_LEVEL。 したがって、コールバック ルーチンは、キュー操作を実行したり、ミューテックスを取得する関数を呼び出したりすることはできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | ks.h (Ks.h を含む) |