KSEVENT_ITEM 構造体 (ks.h)
KSEVENT_ITEM構造では、イベント セット内の特定のイベントに対するミニドライバーのサポートについて説明します。
構文
typedef struct {
ULONG EventId;
ULONG DataInput;
ULONG ExtraEntryData;
PFNKSADDEVENT AddHandler;
PFNKSREMOVEEVENT RemoveHandler;
PFNKSHANDLER SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;
メンバー
EventId
イベント セット内のイベントの一意の ID を指定します。
DataInput
イベント データのサイズをバイト単位で指定します。 イベント データは、イベントが発生したときにクライアントに通知する方法を記述する KSEVENTDATA 構造体で始まり、必要に応じて、イベントが発生するタイミングを指定する追加のパラメーターが続きます。 sizeof(KSEVENTDATA) 以上である必要があります。
ExtraEntryData
このイベントの有効化要求ごとにシステムが割り当てる必要がある追加メモリのサイズをバイト単位で指定します。 ドライバーは、このメモリを使用して、イベント要求を追跡するために必要なデータを格納します。 メモリは、イベント有効化要求のKSEVENT_ENTRY構造体の直後 に 割り当てられます。
AddHandler
ミニドライバーが提供する AVStrMiniAddEvent コールバック ルーチンへのポインター。 ストリーム クラス ドライバーでは使用されません。 AVStream ミニドライバーの場合のみ。
RemoveHandler
ミニドライバーが提供する AVStrMiniRemoveEvent コールバック ルーチンへのポインター。 ストリーム クラス ドライバーでは使用されません。 AVStream ミニドライバーの場合のみ。
SupportHandler
ストリーム クラス ドライバーでは使用されません。
注釈
AddHandler メンバーと RemoveHandler メンバーを指定し、イベントを適切にクリーンしないミニドライバーは、リソース (メモリ/ハンドル) リークを引き起こす可能性があります。
要件
| 要件 | 値 |
|---|---|
| Header | ks.h (Ks.h を含む) |