HW_EVENT_DESCRIPTOR 構造体 (strmini.h)

クラス ドライバーは、ミニドライバーの StrMiniEvent ルーチンのいずれかを呼び出すと、有効または無効としてイベントを記述する HW_EVENT_DESCRIPTOR 構造体へのポインターを渡します。

構文

typedef struct _HW_EVENT_DESCRIPTOR {
  BOOLEAN        Enable;
  PKSEVENT_ENTRY EventEntry;
  PKSEVENTDATA   EventData;
  union {
#if ...
    _HW_STREAM_OBJECT           *StreamObject;
#else
    struct _HW_STREAM_OBJECT    *StreamObject;
#endif
#if ...
    _HW_DEVICE_EXTENSION        *DeviceExtension;
#else
    struct _HW_DEVICE_EXTENSION *DeviceExtension;
#endif
  };
  ULONG          EnableEventSetIndex;
  PVOID          HwInstanceExtension;
#if ...
  ULONG          Reserved;
#else
  ULONG          Reserved[2];
#endif
} HW_EVENT_DESCRIPTOR, *PHW_EVENT_DESCRIPTOR;

メンバー

Enable

有効なイベントの場合は TRUE 、無効なイベントの 場合は FALSE に設定されます。

EventEntry

このイベントを説明 するKSEVENT_ENTRY 構造体を指します。

EventData

イベントのこのインスタンスを記述する KSEVENTDATA 構造体を指します。

StreamObject

クラス ドライバーが有効または無効にするイベントを所有するストリームの HW_STREAM_OBJECT をポイントします。イベントがドライバー全体に属している場合は NULL を 指します。

DeviceExtension

ミニドライバーのデバイス拡張機能をポイントします。

EnableEventSetIndex

ストリーム イベントの場合、ストリームのHW_STREAM_INFORMATION構造体の StreamEventsArray メンバー内で設定されたイベントのインデックスを指定します。

デバイス イベントの場合、ミニドライバーのHW_STREAM_HEADER構造体の DeviceEventsArray メンバー内で設定されたイベントのインデックス を 指定します。

HwInstanceExtension

ミニドライバーのインスタンス拡張機能へのポインター。 ミニドライバーは、このバッファーを使用して、ミニドライバーのこのインスタンスにグローバルな個人情報を記録できます。 ミニドライバーは、StreamClassRegisterMinidriver 経由で自身を登録するときに渡すHW_INITIALIZATION_DATA構造体内のこのバッファーのサイズを設定します。

Reserved

システムで使用するために予約されています。 使用しないでください。

Reserved[2]

システムで使用するために予約されています。 使用しないでください。

要件