Condividi tramite

HW_EVENT_DESCRIPTOR struttura (strmini.h)

  • Articolo

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

Questo valore è impostato 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 abilita/disabilita o NULL se l'evento appartiene al driver nel suo complesso.

DeviceExtension

Punta all'estensione del dispositivo del minidriver.

EnableEventSetIndex

Per gli eventi di flusso, questo specifica l'indice del set di eventi all'interno del membro StreamEventsArraydella 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)