Funzione KsCopyObjectBagItems (ks.h)
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. Nella maggior parte dei casi, 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.
Osservazioni
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 e Mutexes in AVStream.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Vedere anche
KsPinGetConnectedFilterInterface