KsFreeObjectCreateItemsByContext, fonction (ks.h)

Article
02/07/2025

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 de l’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 de création avec cette valeur de contexte seront libérés.

Valeur de retour

Retourne STATUS_SUCCESS si l’élément a été libéré, sinon STATUS_OBJECT_NAME_NOT_FOUND.

Remarques

Au lieu de libérer des éléments de création par nom comme KsFreeObjectCreateItems fait, cette fonction libère tous les éléments de création avec un contexte spécifique. Par exemple, tous les éléments de création associés à une fabrique de filtre auront la fabrique en tant que 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 d’entrées de création.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib

Voir aussi

KsFreeObjectCreateItem

Partager via