Metodo IPortEvents::GenerateEventList (portcls.h)

Articolo
08/07/2023

Il GenerateEventList metodo 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 valore Set di VALORI 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 inclusi nell'intervallo compreso tra 0 e n-1. Vengono segnalate solo le voci di evento con ID evento corrispondenti.

[in] PinEvent

Specifica se PinId deve essere usato per qualificare le voci di 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 eventi del driver della porta. In risposta al driver miniport che chiama questo metodo, il driver della porta visualizza l'elenco di voci di evento 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 riuscire se vengono effettuate più chiamate a IRQL > DISPATCH_LEVEL.