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 函数的指针，该函数将在释放设备标头时销毁创建项时调用。 仅当 AllocateEntry 为 TRUE 时，这才有效。

返回值

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

要求

要求 值
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib

另请参阅

KStrItemFreeCallback