Função KsCopyObjectBagItems (ks.h)

Artigo
03/01/2024

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.

Retornar valor

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, mas não todos, dos itens tenham sido copiados de ObjectBagSource para ObjectBagDestination.

Comentários

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 Sacos de objetos e mutexes no AVStream.

Requisitos

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