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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |