PFNKSADDEVENT コールバック関数 (ks.h)
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 を含む) |