KSOBJECT_CREATE_ITEM estructura (ks.h)

La estructura KSOBJECT_CREATE_ITEM se usa para buscar la cadena pasada a una solicitud de creación.

Sintaxis

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

Miembros

Create

Contiene la función create dispatch para esta clase de objeto base determinada. Consulte DRIVER_OBJECT para obtener la firma de este tipo de función.

Context

Apunta a un búfer que se puede usar para almacenar información de contexto específica del tipo de objeto. La información adicional se encuentra en la sección Comentarios a continuación.

ObjectClass

Apunta a una cadena Unicode que identifica la clase de objeto. Esta es la cadena que se usó para registrarse con PnP para una clase determinada de objeto compatible con este dispositivo.

SecurityDescriptor

Contiene un puntero a un SECURITY_DESCRIPTOR para este tipo de objeto; en caso contrario, NULL. Si se usa la seguridad, debe liberarse cuando el tipo de objeto ya no se use. Debe usar la memoria del grupo y no se puede compartir, ya que se puede reemplazar. Si se modifica, se actualiza el elemento Flags . Opcional.

Flags

Especifica el tipo de solicitud. Las marcas pueden tener los valores enumerados en la tabla siguiente.

Marca Descripción
KSCREATE_ITEM_SECURITYCHANGED Indica que el descriptor de seguridad de este tipo de objeto se ha cambiado y debe conservarse.
KSCREATE_ITEM_WILDCARD Indica que este elemento de creación representa un carácter comodín que se usa para cualquier solicitud de creación que no coincida con ningún otro elemento de creación. El orden de la entrada de comodín en la lista de elementos de creación es irrelevante. Solo una única entrada de comodín es válida en cualquier lista de elementos de creación.
KSCREATE_ITEM_NOPARAMETERS Indica que este elemento de creación no permite pasar ningún parámetro y produce un error si se encuentra alguno. Normalmente, los parámetros de creación se pasan al controlador de creación. No se puede usar con una marca de comodín.

Comentarios

Un puntero a la estructura KSOBJECT_CREATE_ITEM se coloca en el miembro DriverContext de Irp-Tail.Overlay> antes de crear el objeto. Puede acceder a este puntero mediante la macro KSCREATE_ITEM_IRP_STORAGE. Esta macro y las macros relacionadas se incluyen en ks.h.

El minidriver podría recuperar este puntero al crear un nuevo objeto para examinar el campo Contexto .

Requisitos

Requisito Valor
Header ks.h (incluye Ks.h)

Consulte también

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsFilterFactoryAddCreateItem