Función KsGenerateEventList (ks.h)

Artículo
08/07/2023

La función KsGenerateEventList enumera la lista de eventos y busca el evento especificado que se va a generar.

Sintaxis

KSDDKAPI VOID KsGenerateEventList(
  [in, optional] GUID              *Set,
  [in]           ULONG             EventId,
  [in]           PLIST_ENTRY       EventsList,
  [in]           KSEVENTS_LOCKTYPE EventsFlags,
  [in]           PVOID             EventsLock
);

Parámetros

[in, optional] Set

Especifica un conjunto opcional al que pertenece el evento que se va a generar. Si está presente, este valor se compara con el identificador establecido para cada evento de la lista. Si no está presente, los identificadores establecidos se omiten y solo se usa el identificador de evento específico en la comparación para los eventos coincidentes de la lista. Esta comparación ahorra tiempo cuando se sabe que todos los eventos están contenidos en un único conjunto.

[in] EventId

Especifica el identificador de evento específico que se va a buscar en la lista.

[in] EventsList

Apunta al encabezado de la lista de KSEVENT_ENTRY elementos en los que se puede encontrar el evento.

[in] EventsFlags

Especifica la marca KSEVENTS_LOCKTYPE que especifica el tipo de bloqueo de exclusión que se va a usar para acceder a la lista de eventos. Si no se establece ninguna marca, no se toma ningún bloqueo.

[in] EventsLock

Se usa para sincronizar el acceso a un elemento de la lista. El bloqueo se toma antes de enumerar la lista y liberarla después de la enumeración.