KsFreeObjectCreateItemsByContext, fonction (ks.h)
Libère tous les éléments de création avec un contexte spécifique.
Syntaxe
KSDDKAPI NTSTATUS KsFreeObjectCreateItemsByContext(
[in] KSDEVICE_HEADER Header,
[in] PVOID Context
);
Paramètres
[in] Header
Pointe vers l’en-tête d’appareil sur lequel les éléments de création sont attachés.
[in] Context
Contient le contexte des éléments de création à libérer. Tous les éléments créés avec cette valeur de contexte seront libérés.
Valeur retournée
Retourne STATUS_SUCCESS si l’élément a été libéré, sinon STATUS_OBJECT_NAME_NOT_FOUND.
Remarques
Au lieu de libérer les éléments créés par leur nom, comme le fait KsFreeObjectCreateItems , cette fonction libère tous les éléments créés avec un contexte spécifique. Par exemple, tous les éléments de création associés à une fabrique de filtre auront la fabrique comme contexte et peuvent être libérés simultanément avec cet appel au lieu d’un à la fois. Notez que cette fonction ne suppose pas que l’appelant sérialise plusieurs modifications apportées à la liste de création d’entrée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |