KsDiscardEvent, fonction (ks.h)
La fonction KsDiscardEvent ignore la mémoire utilisée par une entrée d’événement après la déréférencement des objets. La fonction peut être appelée lors de la désactivation manuelle d’événements qui n’ont pas été désactivés par le propriétaire de l’événement (en appelant la fonction KsFreeEventList pour désactiver les événements). Par exemple, la fonction peut être appelée lorsque l’activation asynchrone d’un événement échoue et que l’entrée d’événement doit être ignorée.
Syntaxe
KSDDKAPI VOID KsDiscardEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Paramètres
[in] EventEntry
Spécifie le pointeur vers l’entrée à ignorer. Ce pointeur n’est plus valide après un appel réussi à cette fonction.
Valeur de retour
Aucun
Remarques
En règle générale, la fonction KsDiscardEvent est automatiquement appelée par la fonction KsDisableEvent lorsqu’une demande de désactivation d’un événement se produit, ou par la fonction KsFreeEventList lorsqu’une demande de libérer une liste d’événements se produit. Cette fonction ne peut être appelée qu’à PASSIVE_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |