PFNKSITEMFREECALLBACK callback function (ks.h)

A streaming minidriver's KStrItemFreeCallback routine is called to free a previously allocated create item. KStrItemFreeCallback allows the minidriver to perform any cleanup, including flushing security descriptor changes, if necessary.

Syntax

PFNKSITEMFREECALLBACK Pfnksitemfreecallback;

void Pfnksitemfreecallback(
  [in] PKSOBJECT_CREATE_ITEM CreateItem
)
{...}

Parameters

[in] CreateItem

Specifies a create item that was previously allocated by KsAllocateObjectCreateItem.

Return value

None

Remarks

The Context parameter of the KSOBJECT_CREATE_ITEM structure must contain sufficient information to perform cleanup for the create item.

The Flags member of the KSOBJECT_CREATE_ITEM structure indicates if it is necessary to flush security descriptor changes.

Requirements

Requirement Value
Target Platform Desktop
Header ks.h (include Ks.h)

See also

KSOBJECT_CREATE_ITEM

KsAllocateObjectCreateItem