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

Voir aussi

KsFreeObjectCreateItem