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 TRUE 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 estrutura KSEVENTDATA que descreve essa instância do evento.

StreamObject

Aponta para o HW_STREAM_OBJECT para o fluxo que possui o evento 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 de dispositivo do minidriver.

EnableEventSetIndex

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

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

HwInstanceExtension

Ponteiro para a extensão de 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)