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

Weitere Informationen

KsFreeObjectCreateItem