KsCopyObjectBagItems, fonction (ks.h)

Article
02/29/2024

La fonction KsCopyObjectBagItems copie tous les éléments d’un sac 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 retournée

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

Remarques

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

Configuration requise

Condition requise	Valeur
Client minimal 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	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib
IRQL	PASSIVE_LEVEL