Méthode IPortEvents ::GenerateEventList (portcls.h)
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.) |