структура 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 потока.

Для событий устройства это указывает индекс набора событий в элементе DeviceEventsArrayструктуры HW_STREAM_HEADER мини-накопителя.

HwInstanceExtension

Указатель на расширение экземпляра мини-накопителя. Мини-накопитель может использовать этот буфер для записи личных сведений, глобальных в этот экземпляр мини-накопителя. Мини-driver задает размер этого буфера в HW_INITIALIZATION_DATA структуре, которая передается при регистрации с помощью StreamClassRegisterMinidriver.

Reserved

Зарезервировано для системного использования. Не используйте.

Reserved[2]

Зарезервировано для системного использования. Не используйте.

Требования

Требование	Значение
Заголовок	strmini.h (включая Strmini.h)