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
Zeigt auf den Geräteheader, an dem die Erstellungselemente angefügt sind.
[in] Context
Enthält den Kontext der frei zu erstellenden Elemente. Alle Erstellungselemente mit diesem Kontextwert werden freigegeben.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn das Element freigegeben wurde, andernfalls STATUS_OBJECT_NAME_NOT_FOUND.
Hinweise
Anstatt create items by name wie KsFreeObjectCreateItems frei zu geben, gibt diese Funktion alle Erstellungselemente 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 freigegeben werden, anstatt einzeln. Beachten Sie, dass diese Funktion nicht davon ausgeht, dass der Aufrufer mehrere Änderungen an der Erstellungseintragsliste serialisiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |