estructura HW_EVENT_DESCRIPTOR (strmini.h)

Cuando el controlador de clase llama a una de las rutinas de StrMiniEvent del minidriver, pasa un puntero a una estructura de HW_EVENT_DESCRIPTOR para describir el evento como habilitado o deshabilitado.

Sintaxis

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;

Miembros

Enable

Esto se establece en TRUE para un evento habilitado y FALSE para un evento deshabilitado.

EventEntry

Apunta a la estructura KSEVENT_ENTRY que describe este evento.

EventData

Apunta a la estructura KSEVENTDATA que describe esta instancia del evento.

StreamObject

Apunta al HW_STREAM_OBJECT de la secuencia que posee el evento que el controlador de clase está habilitando o deshabilitando, o NULL si el evento pertenece al controlador en su conjunto.

DeviceExtension

Apunta a la extensión del dispositivo del minidriver.

EnableEventSetIndex

En el caso de los eventos de secuencia, especifica el índice del conjunto de eventos dentro del miembro StreamEventsArray de la estructura HW_STREAM_INFORMATION de la secuencia.

En el caso de los eventos de dispositivo, especifica el índice del conjunto de eventos dentro del miembro DeviceEventsArray de la estructura HW_STREAM_HEADER del minidriver.

HwInstanceExtension

Puntero a la extensión de instancia del minidriver. El minidriver puede usar este búfer para registrar información privada global en esta instancia del minidriver. El minidriver establece el tamaño de este búfer en la estructura HW_INITIALIZATION_DATA que pasa cuando se registra a sí mismo a través de StreamClassRegisterMinidriver.

Reserved

Reservado para uso del sistema. No debe usarse.

Reserved[2]

Reservado para uso del sistema. No debe usarse.

Requisitos

Requisito	Valor
Header	strmini.h (include Strmini.h)