KsAllocateObjectBag-Funktion (ks.h)
Die KsAllocateObjectBag-Funktion erstellt einen Objektbehälter und ordnet sie einem KSDEVICE zu.
Syntax
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
Parameter
[in] Device
Ein Zeiger auf eine KSDEVICE , die das Geräteobjekt darstellt, das dem neu erstellten Objektbehälter zugeordnet ist.
[out] ObjectBag
Ein Zeiger auf einen KSOBJECT_BAG (die KSOBJECT_BAG-Struktur entspricht dem Typ PVOID), in dem der neu zugeordnete Objektbehälter abgelegt wird.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn ein neuer Objektbehälter erstellt wird. Wenn ein neuer Objektbehälter nicht zugeordnet ist, wird STATUS_INSUFFICIENT_RESOURCES zurückgegeben.
Hinweise
Ein zugeordneter Objektbehälter wird nicht automatisch gelöscht. Der Minidriver, der KsAllocateObjectBag aufruft , ist für das Löschen der Objekttasche verantwortlich. Die einfachste Möglichkeit hierfür ist der Aufruf von KsFreeObjectBag. Wenn der Minidriver über die Adressen der Elemente in der Tasche verfügt, kann der Minidriver diese einzeln löschen, indem er KsRemoveItemFromObjectBag aufruft.
Weitere Informationen finden Sie unter Objekttaschen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |