структура HW_EVENT_DESCRIPTOR (strmini.h)

Когда драйвер класса вызывает одну из strMiniEvent minidriver, он передает указатель на структуру 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

Указывает на расширение устройства мини-driver.

EnableEventSetIndex

Для событий потока это указывает индекс набора событий в StreamEventsArray члена HW_STREAM_INFORMATION структуры потока.

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

HwInstanceExtension

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

Reserved

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

Reserved[2]

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

Требования