KSOBJECT_CREATE_ITEM结构 (ks.h)

KSOBJECT_CREATE_ITEM 结构用于查找传递给创建请求的字符串。

语法

typedef struct {
  PDRIVER_DISPATCH     Create;
  PVOID                Context;
  UNICODE_STRING       ObjectClass;
  PSECURITY_DESCRIPTOR SecurityDescriptor;
  ULONG                Flags;
} KSOBJECT_CREATE_ITEM, *PKSOBJECT_CREATE_ITEM;

成员

Create

包含此特定基对象类的 create dispatch 函数。 有关此函数类型的签名,请参阅 DRIVER_OBJECT

Context

指向可用于存储特定于对象的对象类型的上下文信息的缓冲区。 其他信息位于下面的“备注”部分。

ObjectClass

指向标识对象类的 Unicode 字符串。 这是用于向 PnP 注册此设备支持的特定对象类的字符串。

SecurityDescriptor

包含指向此类型的对象的 SECURITY_DESCRIPTOR 的指针,否则 NULL。 如果使用安全性,则必须在不再使用对象类型时释放此值。 这必须使用池内存,并且不能共享,因为它可能被替换。 如果进行了修改,则会更新 Flags 元素。 自选。

Flags

指定请求类型。 标志可以具有下表中列出的值。

描述
KSCREATE_ITEM_SECURITYCHANGED 指示此对象类型的安全描述符已更改,应保留。
KSCREATE_ITEM_WILDCARD 指示此创建项表示用于与任何其他创建项不匹配的任何创建请求的通配符。 创建项列表中通配符条目的排序无关紧要。 在任何创建项列表中,只有一个通配符条目有效。
KSCREATE_ITEM_NOPARAMETERS 指示此创建项不允许传递任何参数,如果找到任何参数,则失败。 通常,创建参数将传递给创建处理程序。 这不能与通配符标志一起使用。

言论

指向KSOBJECT_CREATE_ITEM结构的指针放置在创建对象之前 Irp->Tail.OverlayDriverContext 成员中。 可以使用KSCREATE_ITEM_IRP_STORAGE宏访问此指针。 此宏和相关宏包含在 ks.h中。

创建用于检查 上下文 字段的新对象时,微型驱动程序可能会检索此指针。

要求

要求 价值
标头 ks.h (包括 Ks.h)

另请参阅

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsFilterFactoryAddCreateItem