共用方式為

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 則設定為 FALSE。

EventEntry

指向描述此事件的 KSEVENT_ENTRY 結構。

EventData

指向描述此事件實例的 KSEVENTDATA 結構。

StreamObject

指向擁有類別驅動程式啟用/停用之事件之數據流 的HW_STREAM_OBJECT ，如果事件屬於整個驅動程式，則為 NULL 。

DeviceExtension

指向迷你驅動程式的裝置擴充功能。

EnableEventSetIndex

對於數據流事件，這會指定數據流HW_STREAM_INFORMATION結構之 StreamEventsArray 成員內事件集的索引。

針對裝置事件，這會指定minidriver HW_STREAM_HEADER結構之DeviceEventsArray成員內事件集的索引。

HwInstanceExtension

迷你驅動程序實例延伸模組的指標。 迷你驅動程式可以使用這個緩衝區，將私人信息記錄到迷你驅動程式的這個實例。 迷你驅動程式會在透過 StreamClassRegisterMinidriver 註冊自己時，在HW_INITIALIZATION_DATA結構中設定此緩衝區的大小。

Reserved

保留供系統使用。 請勿使用。

Reserved[2]

保留供系統使用。 請勿使用。

規格需求

需求 值
標頭 strmini.h (包含 Strmini.h)