KsAllocateObjectCreateItem 函数 （ks.h）

KsAllocateObjectCreateItem 函数为指定的创建项分配一个槽，可以选择分配用于和复制创建项数据的空间。 此函数假定调用方正在序列化对创建条目列表的多个更改。

语法

KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
  [in]           KSDEVICE_HEADER       Header,
  [in]           PKSOBJECT_CREATE_ITEM CreateItem,
  [in]           BOOLEAN               AllocateEntry,
  [in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);

参数

[in] Header

指向附加创建项的设备标头。

[in] CreateItem

包含要附加的创建项。

[in] AllocateEntry

指示传递的创建项指针是否应直接附加到标头，还是应改为创建其副本。

[in, optional] ItemFreeCallback

（可选）包含指向微型驱动程序定义的 KStrItemFreeCallback 函数的指针，在释放设备标头时销毁创建项时要调用。 仅当 AllocateEntryTRUE时才有效。

返回值

如果分配并附加了新项，则返回STATUS_SUCCESS。 否则，它将返回STATUS_INSUFFICIENT_RESOURCES。

要求

另请参阅

KStrItemFreeCallback