Funzione KsFreeObjectCreateItemsByContext (ks.h)

Libera tutti gli elementi con un contesto specifico.

Sintassi

KSDDKAPI NTSTATUS KsFreeObjectCreateItemsByContext(
  [in] KSDEVICE_HEADER Header,
  [in] PVOID           Context
);

Parametri

[in] Header

Punta all'intestazione del dispositivo in cui sono collegati gli elementi di creazione.

[in] Context

Contiene il contesto della creazione di elementi da liberare. Tutti gli elementi di creazione con questo valore di contesto verranno liberati.

Valore restituito

Restituisce STATUS_SUCCESS se l'elemento è stato liberato, altrimenti STATUS_OBJECT_NAME_NOT_FOUND.

Commenti

Invece di liberare elementi per nome come KsFreeObjectCreateItems , questa funzione libera tutti gli elementi con un contesto specifico. Ad esempio, tutti gli elementi di creazione associati a una factory di filtro avranno la factory come contesto e possono essere liberati simultaneamente con questa chiamata anziché una alla volta. Si noti che questa funzione non presuppone che il chiamante serializzi più modifiche all'elenco di voci di creazione.

Requisiti

Vedi anche

KsFreeObjectCreateItem