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 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 en la 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

Ninguno

Observaciones

Normalmente, la función KsDiscardEvent 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	Valor
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
biblioteca de	Ks.lib

Consulte también

KsDisableEvent

KsFreeEventList