Metodo IPortEvents::GenerateEventList (portcls.h)
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.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Intestazione | portcls.h (include Portcls.h) |
IRQL | Qualsiasi livello. Vedere la sezione Note. |