IPortEvents ::GenerateEventList, méthode (portcls.h)
La méthode GenerateEventList 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. Définir est un paramètre facultatif. Un Définir valeur de NULL est un caractère générique qui correspond à toutes les GUID de jeu d’événements dans la liste. Sinon, seules les entrées d’événement 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 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 est FAUX, PinId est traité comme un caractère générique qui correspond à tous les ID d’épingle de la liste.
[in] PinId
Spécifie l’ID d’épingle de l’événement à signaler. Si pinEvent est TRUE, seules les entrées d’événement avec des ID de broche correspondants sont signalées.
[in] NodeEvent
Indique si nodeId doit être utilisé pour qualifier les entrées d’événement à signaler. Si NodeEvent est FALSE, NodeId est traité comme un caractère 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 est TRUE, seules les entrées d’événement avec des ID de nœud correspondants sont signalées.
Valeur de retour
Aucun
Remarques
Cette méthode est utilisée par les pilotes miniport pour signaler les entrées d’événement dans la liste des événements du pilote de port. En réponse au pilote miniport appelant cette méthode, le pilote de port guide sa liste d’entrées d’événement et signale toutes les entrées d’événement inscrites qui répondent aux critères exprimés par les paramètres d’appel.
Bien que les appelants de GenerateEventList puissent s’exécuter à n’importe quel runtime IRQL, ils sont soumis à certaines limitations lors de l’appel au > DISPATCH_LEVEL IRQL. 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 des événements. Cette DPC contient le contexte de paramètre pour un seul appel. Par conséquent, les événements de signalisation peuvent parfois être manqués si plusieurs appels sont effectués au > DISPATCH_LEVEL IRQL.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| IRQL | N’importe quel niveau. (Voir la section Remarques.) |