KsCopyObjectBagItems - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ks.h

KSDDKAPI NTSTATUS KsCopyObjectBagItems(
  [in] KSOBJECT_BAG ObjectBagDestination,
  [in] KSOBJECT_BAG ObjectBagSource
);

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-ks-kscopyobjectbagitems)

KsCopyObjectBagItems function

Description

The KsCopyObjectBagItems function copies all items from one object bag into another.

Parameters

ObjectBagDestination [in]

The KSOBJECT_BAG (equivalent to type PVOID) into which to copy items.

ObjectBagSource [in]

The KSOBJECT_BAG from which items are copied to ObjectBagDestination.

Return value

Returns STATUS_SUCCESS if the copy is successful. Otherwise, it returns an error code. Most often, this is STATUS_INSUFFICIENT_RESOURCES indicating insufficient system resources to complete the copy operation. If STATUS_INSUFFICIENT_RESOURCES is returned, it is quite possible that some, but not all, of the items have been copied from ObjectBagSource to ObjectBagDestination.

Remarks

Note that mutexes for both bags should be held. If the object bag in question is associated with a filter or a pin, acquire the filter control mutex. If the object bag belongs to a filter factory or the device, acquire the device mutex. For more information, see Object Bags and Mutexes in AVStream.

See also

KsAddItemToObjectBag

KsAllocateObjectBag

KsDiscard

KsFreeObjectBag

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinGetReferenceClockInterface

KsPinSetPinClockTime

KsRemoveItemFromObjectBag

_KsEdit