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]

预留给系统使用。 请勿使用。

要求

要求	值
Header	strmini.h (包括 Strmini.h)