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) |
库 | Ks.lib |
IRQL | PASSIVE_LEVEL |