KsFreeObjectCreateItemsByContext-Funktion (ks.h)
Gibt alle Erstellungselemente mit einem bestimmten Kontext frei.
Syntax
KSDDKAPI NTSTATUS KsFreeObjectCreateItemsByContext(
[in] KSDEVICE_HEADER Header,
[in] PVOID Context
);
Parameter
[in] Header
Verweist auf den Gerätekopf, an dem die Erstellungselemente angefügt sind.
[in] Context
Enthält den Kontext der freizugebenden Elemente zum Erstellen von Elementen. Alle Erstellen von Elementen mit diesem Kontextwert werden freigegeben.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn das Element freigegeben wurde, andernfalls STATUS_OBJECT_NAME_NOT_FOUND.
Bemerkungen
Anstatt Elemente nach Namen als KsFreeObjectCreateItems freizugeben, gibt diese Funktion alle Erstellen von Elementen mit einem bestimmten Kontext frei. Beispielsweise verfügen alle mit einer Filterfactory verknüpften Erstellungselemente über die Factory als Kontext und können gleichzeitig mit diesem Aufruf statt einzeln freigegeben werden. Beachten Sie, dass diese Funktion nicht davon ausgeht, dass der Aufrufer mehrere Änderungen an der Erstellungseintragsliste serialisiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |