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]
システム用に予約されています。 使用しないでください。
必要条件
要件 | 価値 |
---|---|
ヘッダー | strmini.h (Strmini.h を含む) |