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) |