Funzione KsDiscardEvent (ks.h)

La funzione KsDiscardEvent rimuove la memoria usata da una voce di evento dopo che gli oggetti sono stati dereferenziati. La funzione può essere chiamata quando si disabilitano manualmente gli eventi che non sono stati disabilitati dal proprietario dell'evento (chiamando la funzione KsFreeEventList per disabilitare gli eventi). Ad esempio, la funzione può essere chiamata quando l'abilitazione asincrona di un evento ha esito negativo e la voce dell'evento deve essere eliminata.

Sintassi

KSDDKAPI VOID KsDiscardEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

Parametri

[in] EventEntry

Specifica il puntatore alla voce da rimuovere. Questo puntatore non è più valido dopo una chiamata riuscita a questa funzione.

Valore restituito

nessuno

Osservazioni

In genere, la funzione KsDiscardEvent viene chiamata automaticamente dalla funzione KsDisableEvent quando si verifica una richiesta di disabilitare un evento o dalla funzione KsFreeEventList quando si verifica una richiesta di liberare un elenco di eventi. Questa funzione può essere chiamata solo in PASSIVE_LEVEL.

Requisiti

Vedi anche

KsDisableEvent

KsFreeEventList