Función KsDiscardEvent (ks.h)
La función KsDiscardEvent descarta la memoria usada por una entrada de evento después de que los objetos se hayan desreferenciado. Se puede llamar a la función cuando se deshabilitan manualmente los eventos que el propietario del evento no ha deshabilitado (llamando a la función KsFreeEventList para deshabilitar eventos). Por ejemplo, se puede llamar a la función cuando se produce un error de habilitación asincrónica de un evento y es necesario descartar la entrada del evento.
Sintaxis
KSDDKAPI VOID KsDiscardEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Parámetros
[in] EventEntry
Especifica el puntero a la entrada que se va a descartar. Este puntero ya no es válido después de una llamada correcta a esta función.
Valor devuelto
None
Observaciones
Normalmente, la función KsDiscardEvent se llama automáticamente a la función KsDisableEvent cuando se produce una solicitud para deshabilitar un evento o por la función KsFreeEventList cuando se produce una solicitud para liberar una lista de eventos. Solo se puede llamar a esta función en PASSIVE_LEVEL.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |