Condividi tramite

struttura HW_EVENT_DESCRIPTOR (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;

Membri

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 strutturaKSEVENTDATAche 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 di flusso, specifica l'indice del set di eventi all'interno del StreamEventsArray membro della struttura HW_STREAM_INFORMATION del flusso.

Per gli eventi del dispositivo, specifica l'indice del set di eventi all'interno del DeviceEventsArray membro della struttura 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'uso del sistema. Non usare.

Reserved[2]

Riservato per l'uso del sistema. Non usare.

Fabbisogno

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