KsAddObjectCreateItemToDeviceHeader 函数 (ks.h)

  • 项目

KsAddObjectCreateItemToDeviceHeader 函数将指定的创建项添加到此设备标头之前分配的创建项列表中的空项。 空项由条目中的 NULL 创建调度函数表示。 此函数假定调用方正在序列化对创建项列表的多个更改。

语法

KSDDKAPI NTSTATUS KsAddObjectCreateItemToDeviceHeader(
  [in]           KSDEVICE_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

参数

[in] Header

指向包含以前分配的子创建表的设备标头。

[in] Create

指定 create dispatch 函数。

[in] Context

指定上下文参数。

[in] ObjectClass

指定指向以 NULL 结尾的字符串的指针，该字符串将用于对创建请求进行比较。 当设备对象处于活动状态时，此指针必须保持有效。

[in, optional] SecurityDescriptor

指定安全描述符。 当设备对象处于活动状态时，这必须保持有效。 此参数可选。

返回值

如果找到空的创建项槽并添加了项， KsAddObjectCreateItemToDeviceHeader 函数将返回STATUS_SUCCESS。如果失败，则返回STATUS_ALLOTTED_SPACE_EXCEEDED。

要求

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