Metodo IPortEvents::GenerateEventList (portcls.h)

Articolo
02/07/2025

Il metodo GenerateEventList notifica ai client tramite l'elenco di voci di evento del driver di porta che si è verificato un determinato evento.

Sintassi

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

Parametri

[in, optional] Set

Identifica il set di eventi a cui appartiene l'evento. Questo parametro è un puntatore a un GUID. Set è un parametro facoltativo. Un Impostare valore di NULL è un carattere jolly che corrisponde a tutti i GUID del set di eventi nell'elenco. In caso contrario, vengono segnalate solo le voci di evento con GUID del set di eventi corrispondenti.

[in] EventId

Specifica un ID evento. Questo parametro specifica l'indice dell'evento nel set di eventi. Se un set di eventi contiene n eventi, gli ID evento validi sono compresi nell'intervallo da 0 a n-1. Vengono segnalate solo le voci di evento con ID evento corrispondenti.

[in] PinEvent

Specifica se PinId deve essere utilizzato per qualificare le voci dell'evento da segnalare. Se PinEvent è FALSE, PinId viene considerato come un carattere jolly che corrisponde a tutti gli ID pin nell'elenco.

[in] PinId

Specifica l'ID pin dell'evento da segnalare. Se PinEvent è TRUE, vengono segnalate solo le voci di evento con ID pin corrispondenti.

[in] NodeEvent

Indica se NodeId deve essere usato per qualificare le voci di evento da segnalare. Se NodeEvent è FALSE, NodeId viene considerato come un carattere jolly che corrisponde a tutti gli ID nodo nell'elenco.

[in] NodeId

Specifica l'ID nodo dell'evento da segnalare. Se NodeEvent è TRUE, vengono segnalate solo le voci di evento con ID nodo corrispondenti.

Valore restituito

Nessuno

Osservazioni

Questo metodo viene usato dai driver miniport per segnalare le voci degli eventi nell'elenco di eventi del driver di porta. In risposta al driver miniport che chiama questo metodo, il driver della porta visualizza l'elenco delle voci degli eventi e segnala tutte le voci di evento registrate che soddisfano i criteri espressi dai parametri di chiamata.

Anche se i chiamanti di GenerateEventList possono essere eseguiti in qualsiasi IRQL, sono soggetti ad alcune limitazioni durante la chiamata a IRQL > DISPATCH_LEVEL. In particolare, se l'implementazione corrente di GenerateEventList viene chiamata in IRQL > DISPATCH_LEVEL, il metodo accoda un DPC per elaborare l'elenco di eventi. Tale DPC contiene il contesto del parametro per una singola chiamata. Di conseguenza, gli eventi di segnalazione potrebbero occasionalmente non essere rilevati se vengono effettuate più chiamate in IRQL > DISPATCH_LEVEL.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	portcls.h (include Portcls.h)
IRQL	Qualsiasi livello. Vedere la sezione Osservazioni.

Vedere anche

EventHandler

IPortEvents

IPortEvents::AddEventToEventList

Condividi tramite