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

[アーティクル]
08/07/2023

AVStream ミニドライバーの AVStrMiniAddEvent ルーチンは、クライアントがイベントの通知を受け取るために登録するときに呼び出されます。このルーチンは省略可能です。

構文

PFNKSADDEVENT Pfnksaddevent;

NTSTATUS Pfnksaddevent(
  [in] PIRP Irp,
  [in] PKSEVENTDATA EventData,
  [in] _KSEVENT_ENTRY *EventEntry
)
{...}

パラメーター

[in] Irp

イベントの追加要求を記述する IRP を指定します。

[in] EventData

このイベントの通知メソッドを記述する KSEVENTDATA 構造体へのポインター。

[in] EventEntry

イベントのトリガー方法を記述する AVStream によって生成された KSEVENT_ENTRY 構造体へのポインター。

戻り値

AVStrMiniAddEvent は、STATUS_SUCCESSまたは有効になっているイベントに固有のエラーを返す必要があります。

注釈

add イベントハンドラーを指定しない場合、AVStream はイベントをオブジェクトリストに追加します。 AVStream でのイベント処理に関するページを参照してください。

多くの場合、このコールバックはベンダー固有の動作を実装し、 KsFilterAddEvent または KsPinAddEvent を呼び出します。ミニドライバーは、KsFilterAddEvent または KsPinAddEvent の呼び出しでここで受信した EventEntry ポインターを渡します。

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

AVStream ミニドライバーが AddHandler を NULL 以外として指定した場合、AVStream はオブジェクトのイベントリストに項目を追加しません。ミニドライバーが AddHandler を指定し、 KsDefaultAddEventHandler() または Ks*AddEvent 呼び出しを介してオブジェクトのイベントリストにイベントを追加しない場合、ミニドライバーはイベントのクリーンアップを担当します。

要件

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