KsFreeObjectCreateItemsByContext function (ks.h)

Frees all create items with a specific context.

Syntax

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

Parameters

[in] Header

Points to the device header on which the create items are attached.

[in] Context

Contains the context of the create items to free. All create items with this context value will be freed.

Return value

Returns STATUS_SUCCESS if the item was freed, else STATUS_OBJECT_NAME_NOT_FOUND.

Remarks

Instead of freeing create items by name as KsFreeObjectCreateItems does, this function will free all create items with a specific context. For example, all create items associated with a filter factory will have the factory as context and can be freed simultaneously with this call instead of one at a time. Note that this function does not assume that the caller is serializing multiple changes to the create entry list.

Requirements

See also

KsFreeObjectCreateItem