Função KsCopyObjectBagItems (ks.h)

A função KsCopyObjectBagItems copia todos os itens de um recipiente de objetos para outro.

Sintaxe

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

Parâmetros

[in] ObjectBagDestination

O KSOBJECT_BAG (equivalente ao tipo PVOID) no qual copiar itens.

[in] ObjectBagSource

O KSOBJECT_BAG do qual os itens são copiados para ObjectBagDestination.

Valor de retorno

Retorna STATUS_SUCCESS se a cópia for bem-sucedida. Caso contrário, ele retornará um código de erro. Na maioria das vezes, isso é STATUS_INSUFFICIENT_RESOURCES indicando recursos insuficientes do sistema para concluir a operação de cópia. Se STATUS_INSUFFICIENT_RESOURCES for retornado, é bem possível que alguns itens, mas não todos, tenham sido copiados de ObjectBagSource para ObjectBagDestination.

Observações

Observe que os mutexes para ambas as bolsas devem ser mantidos. Se o recipiente de objetos em questão estiver associado a um filtro ou um pino, adquira o mutex de controle de filtro. Se o recipiente de objetos pertencer a uma fábrica de filtros ou ao dispositivo, adquira o mutex do dispositivo. Para obter mais informações, consulte Object Bags and Mutexes in AVStream.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX.
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib
IRQL	PASSIVE_LEVEL

Consulte também

KsAddItemToObjectBag

KsAllocateObjectBag

KsDiscard

KsFreeObjectBag

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinGetReferenceClockInterface

KsPinSetPinClockTime

KsRemoveItemFromObjectBag

_KsEdit