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