Método IPortEvents::GenerateEventList (portcls.h)
El método GenerateEventList notifica a los clientes a través de la lista de entradas de evento del controlador de puerto que se ha producido un evento determinado.
Sintaxis
void GenerateEventList(
[in, optional] GUID *Set,
[in] ULONG EventId,
[in] BOOL PinEvent,
[in] ULONG PinId,
[in] BOOL NodeEvent,
[in] ULONG NodeId
);
Parámetros
[in, optional] Set
Identifica el conjunto de eventos al que pertenece el evento. Este parámetro es un puntero a un GUID. Set es un parámetro opcional. Un valor set de NULL es un comodín que coincide con todos los GUID del conjunto de eventos de la lista. De lo contrario, solo se indican las entradas de evento con GUID de conjunto de eventos coincidentes.
[in] EventId
Especifica un identificador de evento. Este parámetro especifica el índice del evento en el conjunto de eventos. Si un conjunto de eventos contiene eventos n, los identificadores de evento válidos están en el intervalo de 0 a n-1. Solo se indican las entradas de evento con identificadores de evento coincidentes.
[in] PinEvent
Especifica si pinId deben usarse para calificar qué entradas de evento se van a indicar. Si PinEvent es FALSE, PinId se trata como una tarjeta comodín que coincide con todos los identificadores de pin de la lista.
[in] PinId
Especifica el identificador de patilla del evento que se va a indicar. Si PinEvent es TRUE, solo se indican las entradas de evento con identificadores de pin coincidentes.
[in] NodeEvent
Indica si NodeId deben usarse para calificar qué entradas de evento se van a indicar. Si NodeEvent es FALSE, NodeId se trata como una tarjeta comodín que coincide con todos los identificadores de nodo de la lista.
[in] NodeId
Especifica el identificador de nodo del evento que se va a indicar. Si NodeEvent es TRUE, solo se indican las entradas de evento con identificadores de nodo coincidentes.
Valor devuelto
Ninguno
Observaciones
Los controladores de miniport usan este método para indicar entradas de eventos en la lista de eventos del controlador de puerto. En respuesta al controlador de miniportar que llama a este método, el controlador de puerto recorre su lista de entradas de eventos y señala todas las entradas de eventos registradas que cumplen los criterios expresados por los parámetros de llamada.
Aunque los autores de llamadas de GenerateEventList se pueden ejecutar en cualquier IRQL, están sujetos a algunas limitaciones al llamar a irQL > DISPATCH_LEVEL. En concreto, si se llama a la implementación actual de GenerateEventList en irQL > DISPATCH_LEVEL, el método pone en cola un DPC para procesar la lista de eventos. Ese DPC contiene el contexto de parámetro para una sola llamada. Como resultado, es posible que se pierdan ocasionalmente eventos de señalización si se realizan varias llamadas en irQL > DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | portcls.h (incluya Portcls.h) |
| irQL | Cualquier nivel. (Consulte la sección Comentarios). |