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)