Função KsDiscardEvent (ks.h)

A função KsDiscardEvent descarta a memória usada por uma entrada de evento depois que os objetos são desreferenciados. A função pode ser chamada ao desabilitar manualmente eventos que não foram desabilitados pelo proprietário do evento (chamando a função KsFreeEventList para desabilitar eventos). Por exemplo, a função pode ser chamada quando a habilitação assíncrona de um evento falha e a entrada de evento precisa ser descartada.

Sintaxe

KSDDKAPI VOID KsDiscardEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

Parâmetros

[in] EventEntry

Especifica o ponteiro para a entrada a ser descartada. Esse ponteiro não é mais válido após uma chamada bem-sucedida para essa função.

Retornar valor

Nenhum

Comentários

Normalmente, a função KsDiscardEvent é chamada automaticamente pela função KsDisableEvent quando ocorre uma solicitação para desabilitar um evento ou pela função KsFreeEventList quando ocorre uma solicitação para liberar uma lista de eventos. Essa função só pode ser chamada em PASSIVE_LEVEL.

Requisitos

Confira também

KsDisableEvent

KsFreeEventList