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

对于流事件，这指定 StreamEventsArray 中事件集的索引 流的 HW_STREAM_INFORMATION 结构的成员。

对于设备事件，这将指定微型驱动程序 HW_STREAM_HEADER 结构的 DeviceEventsArray 中事件集的索引 成员。

HwInstanceExtension

指向微型驱动程序实例扩展的指针。 微型驱动程序可以使用此缓冲区将私有信息记录到此微型驱动程序实例的全局信息。 微型驱动程序在通过 StreamClassRegisterMinidriver 注册自身时，在 HW_INITIALIZATION_DATA 结构中设置此缓冲区的大小。

Reserved

保留供系统使用。 请勿使用。

Reserved[2]

保留供系统使用。 请勿使用。

要求

要求	价值
标头	strmini.h （包括 Strmini.h）