Função KsGenerateEventList (ks.h)

Artigo
02/29/2024

A função KsGenerateEventList enumera a lista de eventos e pesquisa o evento especificado a ser gerado.

Sintaxe

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 um conjunto opcional ao qual o evento a ser gerado pertence. Se estiver presente, esse valor será comparado com o identificador de conjunto para cada evento na lista. Se não estiver presente, os identificadores do conjunto serão ignorados e apenas o identificador de evento específico será usado na comparação para eventos correspondentes na lista. Essa comparação economiza tempo quando todos os eventos são conhecidos por estarem contidos em um único conjunto.

[in] EventId

Especifica o identificador de evento específico a ser buscado na lista.

[in] EventsList

Aponta para o cabeçalho da lista de KSEVENT_ENTRY itens nos quais o evento pode ser encontrado.

[in] EventsFlags

Especifica o sinalizador KSEVENTS_LOCKTYPE especificando o tipo de bloqueio de exclusão a ser usado no acesso à lista de eventos. Se nenhum sinalizador estiver definido, nenhum bloqueio será tomado.

[in] EventsLock

Usado para sincronizar o acesso a um elemento na lista. O bloqueio é feito antes de enumerar a lista e liberado após a enumeração.