Поделиться через

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

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

Reserved

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

Reserved[2]

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

Требования

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