Edit

Share via

KsFreeObjectCreateItemsByContext function (ks.h)

  • Article

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

Requirement Value
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib

See also

KsFreeObjectCreateItem