KsCopyObjectBagItems-Funktion (ks.h)

Die KsCopyObjectBagItems Funktion kopiert alle Elemente aus einem Objektbehälter in einen anderen.

Syntax

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

Parameter

[in] ObjectBagDestination

Die KSOBJECT_BAG (entspricht dem Typ PVOID), in den Elemente kopiert werden sollen.

[in] ObjectBagSource

Die KSOBJECT_BAG, aus der Elemente in ObjectBagDestination kopiert werden.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn die Kopie erfolgreich ist. Andernfalls wird ein Fehlercode zurückgegeben. Dies ist meistens STATUS_INSUFFICIENT_RESOURCES, der angibt, dass nicht genügend Systemressourcen zum Abschließen des Kopiervorgangs vorhanden sind. Wenn STATUS_INSUFFICIENT_RESOURCES zurückgegeben wird, ist es durchaus möglich, dass einige, aber nicht alle Elemente aus ObjectBagSource- in ObjectBagDestinationkopiert wurden.

Bemerkungen

Beachten Sie, dass Mutexen für beide Taschen gehalten werden sollten. Wenn der fragliche Objektbehälter einem Filter oder einem Pin zugeordnet ist, rufen Sie das Filtersteuerelement mutex ab. Wenn der Objektbehälter zu einer Filterfabrik oder zum Gerät gehört, rufen Sie den Gerätemutex ab. Weitere Informationen finden Sie unter Object Bags und Mutexes in AVStream.

Anforderungen

Siehe auch

KsAddItemToObjectBag

KsAllocateObjectBag

KsDiscard-

KsFreeObjectBag-

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinGetReferenceClockInterface

KsPinSetPinClockTime-

KsRemoveItemFromObjectBag

_KsEdit