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 de 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 le HW_STREAM_OBJECT pour le flux qui possè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 de l’appareil du minidriver.

EnableEventSetIndex

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

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

HwInstanceExtension

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

Reserved

Réservé pour le système. Ne pas utiliser.

Reserved[2]

Réservé pour le système. Ne pas utiliser.

Configuration requise

Condition requise Valeur
En-tête strmini.h (inclure Strmini.h)