KsCopyObjectBagItems-Funktion (ks.h)
Die KsCopyObjectBagItems-Funktion kopiert alle Elemente aus einem Objektbehälter in eine andere.
Syntax
KSDDKAPI NTSTATUS KsCopyObjectBagItems(
[in] KSOBJECT_BAG ObjectBagDestination,
[in] KSOBJECT_BAG ObjectBagSource
);
Parameter
[in] ObjectBagDestination
Die KSOBJECT_BAG (entspricht dem Typ PVOID), in den Elemente kopiert werden sollen.
[in] ObjectBagSource
Die KSOBJECT_BAG, aus der Elemente in ObjectBagDestination kopiert werden.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn die Kopie erfolgreich war. Andernfalls wird ein Fehlercode zurückgegeben. In den meisten Fällen ist dies STATUS_INSUFFICIENT_RESOURCES, was darauf hinweist, dass die Systemressourcen nicht ausreichen, um den Kopiervorgang abzuschließen. Wenn STATUS_INSUFFICIENT_RESOURCES zurückgegeben wird, ist es durchaus möglich, dass einige, aber nicht alle Elemente aus ObjectBagSource nach ObjectBagDestination kopiert wurden.
Hinweise
Beachten Sie, dass Mutexe für beide Taschen gehalten werden sollten. Wenn der betreffende Objektbehälter einem Filter oder einem Pin zugeordnet ist, rufen Sie den Mutex des Filtersteuerelements ab. Wenn der Objektbehälter zu einer Filterfactory oder dem Gerät gehört, rufen Sie den Gerätemutex ab. Weitere Informationen finden Sie unter Objektbehälter und Mutexes in AVStream.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Weitere Informationen
KsPinGetConnectedFilterInterface