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 メンバーを指定し、イベントを適切にクリーンしないミニドライバーは、リソース (メモリ/ハンドル) リークを引き起こす可能性があります。

要件

こちらもご覧ください

IOCTL_KS_DISABLE_EVENT

KSEVENTDATA

KSEVENT_ENTRY

KsDefaultAddEventHandler