Funzione KsFreeObjectCreateItemsByContext (ks.h)
Libera tutti gli elementi creati 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 creati con questo valore di contesto verranno liberati.
Valore restituito
Restituisce STATUS_SUCCESS se l'elemento è stato liberato, altrimenti STATUS_OBJECT_NAME_NOT_FOUND.
Osservazioni
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 contemporaneamente con questa chiamata anziché uno alla volta. Si noti che questa funzione non presuppone che il chiamante serializzi più modifiche all'elenco di voci di creazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |