Função KsDiscardEvent (ks.h)
A função KsDiscardEvent descarta a memória usada por uma entrada de evento após a desreferência dos objetos. 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.
Valor de retorno
Nenhum
Observações
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 |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |