KsDiscardEvent-Funktion (ks.h)
Die KsDiscardEvent-Funktion verwirft den von einem Ereigniseintrag verwendeten Arbeitsspeicher, nachdem die Objekte dereferenziert wurden. Die Funktion kann aufgerufen werden, wenn Ereignisse, die nicht vom Ereignisbesitzer deaktiviert wurden, manuell deaktiviert werden (durch Aufrufen der KsFreeEventList-Funktion zum Deaktivieren von Ereignissen). Die Funktion kann beispielsweise aufgerufen werden, wenn bei der asynchronen Aktivierung eines Ereignisses ein Fehler auftritt und der Ereigniseintrag verworfen werden muss.
Syntax
KSDDKAPI VOID KsDiscardEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Parameter
[in] EventEntry
Gibt den Zeiger auf den zu verwerfenden Eintrag an. Dieser Zeiger ist nach einem erfolgreichen Aufruf dieser Funktion nicht mehr gültig.
Rückgabewert
Keine
Bemerkungen
In der Regel wird die KsDiscardEvent-Funktion automatisch von der KsDisableEvent-Funktion aufgerufen, wenn eine Anforderung zum Deaktivieren eines Ereignisses auftritt, oder von der KsFreeEventList-Funktion , wenn eine Anforderung zum Freigeben einer Liste von Ereignissen auftritt. Diese Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |