KsCopyObjectBagItems, fonction (ks.h)

Article
02/07/2025

La fonction KsCopyObjectBagItems copie tous les éléments d’un conteneur d’objets dans un autre.

Syntaxe

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

Paramètres

[in] ObjectBagDestination

Le KSOBJECT_BAG (équivalent au type PVOID) dans lequel copier des éléments.

[in] ObjectBagSource

Le KSOBJECT_BAG à partir duquel les éléments sont copiés dans ObjectBagDestination.

Valeur de retour

Retourne STATUS_SUCCESS si la copie réussit. Sinon, elle retourne un code d’erreur. Le plus souvent, il s’agit STATUS_INSUFFICIENT_RESOURCES indiquant des ressources système insuffisantes pour effectuer l’opération de copie. Si STATUS_INSUFFICIENT_RESOURCES est retourné, il est tout à fait possible que certains éléments, mais pas tous, aient été copiés de ObjectBagSource à ObjectBagDestination.

Remarques

Notez que les mutex pour les deux sacs doivent être conservés. Si le conteneur d’objets en question est associé à un filtre ou à une broche, achetez le mutex de contrôle de filtre. Si le conteneur d’objets appartient à une fabrique de filtre ou à l’appareil, achetez le mutex de l’appareil. Pour plus d’informations, consultez sacs d’objets et mutexes dans AVStream.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX.
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib
IRQL	PASSIVE_LEVEL