Méthode IPortEvents ::GenerateEventList (portcls.h)

  • Article

La GenerateEventList méthode avertit les clients par le biais de la liste des entrées d’événement du pilote de port qu’un événement particulier s’est produit.

Syntaxe

void GenerateEventList(
  [in, optional] GUID  *Set,
  [in]           ULONG EventId,
  [in]           BOOL  PinEvent,
  [in]           ULONG PinId,
  [in]           BOOL  NodeEvent,
  [in]           ULONG NodeId
);

Paramètres

[in, optional] Set

Identifie le jeu d’événements auquel l’événement appartient. Ce paramètre est un pointeur vers un GUID. Set est un paramètre facultatif. Une valeur set null est une carte générique qui correspond à tous les GUID de jeu d’événements de la liste. Sinon, seules les entrées d’événements avec des GUID de jeu d’événements correspondants sont signalées.

[in] EventId

Spécifie un ID d’événement. Ce paramètre spécifie l’index de l’événement dans le jeu d’événements. Si un jeu d’événements contient n événements, les ID d’événement valides se trouvent dans la plage de 0 à n-1. Seules les entrées d’événement avec des ID d’événement correspondants sont signalées.

[in] PinEvent

Spécifie si PinId doit être utilisé pour qualifier les entrées d’événement à signaler. Si PinEvent a la valeur FALSE, PinId est traité comme un carte générique qui correspond à tous les ID d’épingle de la liste.

[in] PinId

Spécifie l’ID de broche de l’événement à signaler. Si PinEvent a la valeur TRUE, seules les entrées d’événement avec des ID d’épingle correspondants sont signalées.

[in] NodeEvent

Indique si NodeId doit être utilisé pour qualifier les entrées d’événement à signaler. Si NodeEvent a la valeur FALSE, NodeId est traité comme un carte générique qui correspond à tous les ID de nœud de la liste.

[in] NodeId

Spécifie l’ID de nœud de l’événement à signaler. Si NodeEvent a la valeur TRUE, seules les entrées d’événement avec des ID de nœud correspondants sont signalées.

Valeur de retour

None

Remarques

Cette méthode est utilisée par les pilotes miniport pour signaler les entrées d’événements dans la liste des événements du pilote de port. En réponse au pilote miniport appelant cette méthode, le pilote de port examine sa liste d’entrées d’événements et signale toutes les entrées d’événements inscrites qui répondent aux critères exprimés par les paramètres d’appel.

Bien que les appelants de puissent être en cours d’exécution GenerateEventList à n’importe quel IRQL, ils sont soumis à certaines limitations lors de l’appel à l’IRQL > DISPATCH_LEVEL. Plus précisément, si l’implémentation actuelle de GenerateEventList est appelée au DISPATCH_LEVEL IRQL > , la méthode met en file d’attente un DPC pour traiter la liste d’événements. Cette DPC contient le contexte de paramètre d’un seul appel. Par conséquent, des événements de signalisation peuvent parfois être manqués si plusieurs appels sont effectués à l’IRQL > DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête portcls.h (include Portcls.h)
IRQL N’importe quel niveau. (Voir la section Notes.)

Voir aussi

EventHandler

IPortEvents

IPortEvents ::AddEventToEventList