KsAllocateObjectBag 函式 (ks.h)
KsAllocateObjectBag 函式會建立物件包，並將它與 KSDEVICE 產生關聯。
語法
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
參數
[in] Device
KSDEVICE 的指標，代表與新建立的物件包相關聯的裝置物件。
[out] ObjectBag
KSOBJECT_BAG (KSOBJECT_BAG結構的指標相當於儲存新配置物件包的 PVOID) 類型。
傳回值
如果建立新的物件包，則會傳回STATUS_SUCCESS。 如果未配置新的物件包，則會傳回STATUS_INSUFFICIENT_RESOURCES。
備註
配置的物件包不會自動刪除。 呼叫 KsAllocateObjectBag 的迷你驅動程式負責刪除物件包。 若要這樣做，最簡單的方式是呼叫 KsFreeObjectBag。 或者，如果迷你驅動程式具有包中項目的位址，迷你驅動程式可以藉由呼叫 KsRemoveItemFromObjectBag 來個別刪除這些專案。
如需詳細資訊，請參閱 物件包。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Microsoft Windows XP 和更新版本的作業系統和 DirectX 8.0 和更新版本的 DirectX。 |
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |
| IRQL | PASSIVE_LEVEL |