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

另请参阅

KsAddItemToObjectBag

KsCopyObjectBagItems

KsDiscard

KsFreeObjectBag

KsRemoveItemFromObjectBag