Método IPortEvents::GenerateEventList (portcls.h)

Artículo
08/07/2023

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.