Funzione KsCopyObjectBagItems (ks.h)

Articolo
03/05/2024

La funzione KsCopyObjectBagItems copia tutti gli elementi da un contenitore di oggetti in un altro.

Sintassi

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

Parametri

[in] ObjectBagDestination

Il KSOBJECT_BAG (equivalente al tipo PVOID) in cui copiare gli elementi.

[in] ObjectBagSource

Il KSOBJECT_BAG da cui vengono copiati gli elementi in ObjectBagDestination.

Valore restituito

Restituisce STATUS_SUCCESS se la copia ha esito positivo. In caso contrario, restituisce un codice di errore. Spesso, si tratta di STATUS_INSUFFICIENT_RESOURCES che indica risorse di sistema insufficienti per completare l'operazione di copia. Se STATUS_INSUFFICIENT_RESOURCES viene restituito, è possibile che alcuni elementi, ma non tutti, siano stati copiati da ObjectBagSource a ObjectBagDestination.

Commenti

Si noti che i mutex per entrambi i sacchetti devono essere tenuti. Se il contenitore di oggetti in questione è associato a un filtro o a un pin, acquisire il mutex del controllo filtro. Se il contenitore di oggetti appartiene a una factory di filtro o al dispositivo, acquisire il mutex del dispositivo. Per altre informazioni, vedere Contenitori di oggetti e mutex in AVStream.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib
IRQL	PASSIVE_LEVEL