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 dem neu erstellten Objektbehälter zugeordnete Geräteobjekt darstellt.
[out] ObjectBag
Ein Zeiger auf eine 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 kein neuer Objektbehälter zugeordnet ist, wird STATUS_INSUFFICIENT_RESOURCES zurückgegeben.
Bemerkungen
Ein zugeordneter Objektbehälter wird nicht automatisch gelöscht. Der Minidriver, der KsAllocateObjectBag aufruft, ist für das Löschen des Objektbehälters verantwortlich. Die einfachste Möglichkeit hierfür ist das Aufrufen KsFreeObjectBag. Alternativ kann der Minidriver die Adressen der Elemente in der Tasche einzeln löschen, indem er KsRemoveItemFromObjectBagaufruft.
Weitere Informationen finden Sie unter Object Bags.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | PASSIVE_LEVEL |