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.
KSDDKAPI VOID KsDiscardEvent(
[in] PKSEVENT_ENTRY EventEntry
);
[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.
Aucun
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.
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |