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。 |
| 目标平台 | 通用 |
| 标头 | ks.h (包括 Ks.h) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |