Partager via

structure HW_EVENT_DESCRIPTOR (strmini.h)

  • Article

Lorsque le pilote de classe appelle l’une des routines StrMiniEvent du minidriver, il passe un pointeur vers une structure HW_EVENT_DESCRIPTOR pour décrire l’événement comme activé ou désactivé.

Syntaxe

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;

Membres

Enable

Cette valeur est définie sur TRUE pour un événement activé, et FALSE pour un événement désactivé.

EventEntry

Pointe vers la structure KSEVENT_ENTRY qui décrit cet événement.

EventData

Pointe vers la structure KSEVENTDATA qui décrit cette instance de l’événement.

StreamObject

Pointe vers l'HW_STREAM_OBJECT du flux propriétaire de l’événement que le pilote de classe active/désactive, ou NULL si l’événement appartient au pilote dans son ensemble.

DeviceExtension

Pointe vers l’extension d’appareil du minidriver.

EnableEventSetIndex

Pour les événements de flux, cela spécifie l’index de l’ensemble d’événements dans le StreamEventsArray membre de la structure HW_STREAM_INFORMATION du flux.

Pour les événements d’appareil, cela spécifie l’index de l’ensemble d’événements dans le membre DeviceEventsArray de la structure HW_STREAM_HEADER du minidriver.

HwInstanceExtension

Pointeur vers l’extension d’instance du minidriver. Le minidriver peut utiliser cette mémoire tampon pour enregistrer des informations privées globales dans cette instance du minidriver. Le minidriver définit la taille de cette mémoire tampon dans la structure HW_INITIALIZATION_DATA qu’il transmet lorsqu’il s’inscrit via StreamClassRegisterMinidriver.

Reserved

Réservé à l’utilisation du système. N’utilisez pas.

Reserved[2]

Réservé à l’utilisation du système. N’utilisez pas.

Exigences

Exigence Valeur
d’en-tête strmini.h (include Strmini.h)