KsDiscardEvent, fonction (ks.h)
La fonction KsDiscardEvent ignore la mémoire utilisée par une entrée d’événement une fois que les objets ont été déréférencés. 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
None
Remarques
En règle générale, la fonction KsDiscardEvent est appelée automatiquement 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ération d’une liste d’événements se produit. Cette fonction ne peut être appelée qu’à PASSIVE_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |