struttura HW_EVENT_DESCRIPTOR (strmini.h)

Quando il driver di classe chiama una delle routine StrMiniEvent del minidriver, passa un puntatore a una struttura HW_EVENT_DESCRIPTOR per descrivere l'evento come abilitato o disabilitato.

Sintassi

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;

Members

Enable

Questa opzione è impostata su TRUE per un evento abilitato e FALSE per un evento disabilitato.

EventEntry

Punta alla struttura KSEVENT_ENTRY che descrive questo evento.

EventData

Punta alla struttura KSEVENTDATA che descrive questa istanza dell'evento.

StreamObject

Punta al HW_STREAM_OBJECT per il flusso proprietario dell'evento che il driver di classe sta abilitando/disabilitando o NULL se l'evento appartiene al driver nel suo complesso.

DeviceExtension

Punta all'estensione del dispositivo del minidriver.

EnableEventSetIndex

Per gli eventi del flusso, questo specifica l'indice del set di eventi all'interno del membro StreamEventsArray della struttura HW_STREAM_INFORMATION del flusso.

Per gli eventi del dispositivo, questo specifica l'indice del set di eventi all'interno del membro DeviceEventsArray della struttura di HW_STREAM_HEADER del minidriver.

HwInstanceExtension

Puntatore all'estensione dell'istanza del minidriver. Il minidriver può usare questo buffer per registrare informazioni private globali in questa istanza del minidriver. Il minidriver imposta le dimensioni di questo buffer nella struttura HW_INITIALIZATION_DATA che passa quando si registra tramite StreamClassRegisterMinidriver.

Reserved

Riservato per l'utilizzo nel sistema. Non usare.

Reserved[2]

Riservato per l'utilizzo nel sistema. Non usare.

Requisiti

Requisito	Valore
Intestazione	strmini.h (include Strmini.h)