Compartilhar via

estrutura HW_EVENT_DESCRIPTOR (strmini.h)

  • Artigo

Quando o driver de classe chama uma das rotinas StrMiniEvent do minidriver, ele passa um ponteiro para uma estrutura HW_EVENT_DESCRIPTOR para descrever o evento como habilitado ou desabilitado.

Sintaxe

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;

Membros

Enable

Isso é definido como VERDADEIRO para um evento habilitado e FALSE para um evento desabilitado.

EventEntry

Aponta para a estrutura KSEVENT_ENTRY que descreve esse evento.

EventData

Aponta para a estruturaKSEVENTDATA que descreve essa instância do evento.

StreamObject

Aponta para o HW_STREAM_OBJECT do fluxo que possui o evento em que o driver de classe está habilitando/desabilitando ou NULL se o evento pertencer ao driver como um todo.

DeviceExtension

Aponta para a extensão do dispositivo do minidriver.

EnableEventSetIndex

Para eventos de fluxo, isso especifica o índice do conjunto de eventos no streamEventsArray membro da estrutura de HW_STREAM_INFORMATION do fluxo.

Para eventos de dispositivo, isso especifica o índice do conjunto de eventos no DeviceEventsArray membro da estrutura de HW_STREAM_HEADER do minidriver.

HwInstanceExtension

Ponteiro para a extensão da instância do minidriver. O minidriver pode usar esse buffer para registrar informações privadas globais nessa instância do minidriver. O minidriver define o tamanho desse buffer na estrutura HW_INITIALIZATION_DATA que ele passa quando ele se registra por meio de StreamClassRegisterMinidriver.

Reserved

Reservado para uso do sistema. Não use.

Reserved[2]

Reservado para uso do sistema. Não use.

Requisitos

Requisito Valor
cabeçalho strmini.h (inclua Strmini.h)