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

[アーティクル]
03/05/2024

AVStream ミニドライバーの AVStrMiniRemoveEvent ルーチンは、クライアントがイベントの通知キューから削除するように要求すると呼び出されます。このルーチンは省略可能です。

構文

PFNKSREMOVEEVENT Pfnksremoveevent;

void Pfnksremoveevent(
  [in] PFILE_OBJECT FileObject,
  [in] _KSEVENT_ENTRY *EventEntry
)
{...}

パラメーター

[in] FileObject

イベントを削除するファイルオブジェクトへのポインター。

[in] EventEntry

AVStream によって生成された KSEVENT_ENTRY 構造体へのポインター。

戻り値

なし

解説

ミニドライバーは、KSEVENT_ITEM構造体の RemoveHandler メンバーでこのルーチンのアドレスを指定します。 AVStream でのイベント処理では、ミニドライバーがクラスドライバーにこの構造を提供する方法について説明します。

ミニドライバーが AVStrMiniRemoveEvent を提供し、AddHandler を指定しないか、KsXxxAddEvent を呼び出す AddHandler を指定する場合、ミニドライバーの AVStrMiniRemoveEvent は、KSEVENT_ENTRY構造体のLIST_ENTRY構造体へのポインターを使用して RemoveEntryList を呼び出す必要があります。

&EventEntry -> ListEntry

それ以外の場合、 AVStrMiniRemoveEvent は AddHandler で実行された手順を元に戻す必要があります。

要件

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