Função KsGenerateEvent (ks.h)

Artigo
03/05/2024

A função KsGenerateEvent gera uma notificação de evento padrão dada uma estrutura de entrada de evento.

Sintaxe

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

Parâmetros

[in] EventEntry

Especifica a estrutura de entrada de evento que faz referência aos dados do evento. As informações são usadas para determinar que tipo de notificação executar. Se o tipo de notificação não for um dos padrões predefinidos, um erro será retornado. No caso de um único evento não recorrente, essa entrada será inválida ao retornar da função. Portanto, qualquer código que enumera uma lista de eventos deve pré-criar para adquirir o próximo evento na lista antes de passar esse evento para a função.

Retornar valor

A função KsGenerateEvent retorna STATUS_SUCCESS se tiver êxito ou, se não tiver êxito, retornará uma exceção ou erro de memória.

Comentários

Um dispositivo determina quando as notificações de evento são geradas usando a estrutura KSEVENT_ENTRY e, em seguida, usa essa função para executar a notificação real. KsGenerateEvent pode ser chamado em qualquer IRQL. Se chamado acima DISPATCH_LEVEL, a sinalização do evento será executada de forma assíncrona em um DPC.