Método IPortEvents::GenerateEventList (portcls.h)
El GenerateEventList método notifica a los clientes a través de la lista de entradas de eventos 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 carácter 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 coincidentes del conjunto de eventos.
[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 n eventos, 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 Se debe usar PinId en la calificación de las entradas de evento que se van a indicar. Si PinEvent es FALSE, PinId se trata como un carácter 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 señalizar. Si PinEvent es TRUE, solo se señalizan las entradas de evento con identificadores de pin coincidentes.
[in] NodeEvent
Indica si NodeId se debe usar en la calificación de las entradas de evento que se van a indicar. Si NodeEvent es FALSE, NodeId se trata como un carácter 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 señalizan las entradas de evento con identificadores de nodo coincidentes.
Valor devuelto
None
Observaciones
Los controladores de minipuerto usan este método para indicar entradas de eventos en la lista de eventos del controlador de puerto. En respuesta al controlador de minipuerto 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 pueden ejecutarse 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 eventos de señalización ocasionalmente si se realizan varias llamadas en IRQL > DISPATCH_LEVEL.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | portcls.h (incluya Portcls.h) |
| IRQL | Cualquier nivel. (Vea la sección Comentarios.) |