KSOBJECT_CREATE_ITEM estrutura (ks.h)
A estrutura KSOBJECT_CREATE_ITEM é usada para pesquisar a cadeia de caracteres passada para uma solicitação de criação.
Sintaxe
typedef struct {
PDRIVER_DISPATCH Create;
PVOID Context;
UNICODE_STRING ObjectClass;
PSECURITY_DESCRIPTOR SecurityDescriptor;
ULONG Flags;
} KSOBJECT_CREATE_ITEM, *PKSOBJECT_CREATE_ITEM;
Membros
Create
Contém a função criar expedição para esta classe de objeto base específica. Consulte DRIVER_OBJECT para obter a assinatura desse tipo de função.
Context
Aponta para um buffer que pode ser usado para armazenar informações de contexto específicas do tipo de objeto. Informações adicionais estão na seção Comentários abaixo.
ObjectClass
Aponta para uma cadeia de caracteres Unicode que identifica a classe de objeto. Essa é a cadeia de caracteres que foi usada para registrar com PnP para uma classe específica de objeto compatível com esse dispositivo.
SecurityDescriptor
Contém um ponteiro para um SECURITY_DESCRIPTOR para esse tipo de objeto, caso contrário, NULL. Se a segurança for usada, isso deverá ser liberado quando o tipo de objeto não for mais usado. Isso deve usar a memória do pool e não pode ser compartilhado, pois pode ser substituído. Se isso for modificado, o elemento Flags será atualizado. Opcional.
Flags
Especifica o tipo de solicitação. Os sinalizadores podem ter os valores listados na tabela a seguir.
| Bandeira | Descrição |
|---|---|
| KSCREATE_ITEM_SECURITYCHANGED | Indica que o descritor de segurança nesse tipo de objeto foi alterado e deve ser mantido. |
| KSCREATE_ITEM_WILDCARD | Indica que esse item de criação representa um curinga usado para qualquer solicitação de criação que não corresponda a nenhum outro item de criação. A ordenação da entrada de curinga na lista de itens de criação é irrelevante. Apenas uma única entrada de curinga é válida em qualquer lista de itens de criação. |
| KSCREATE_ITEM_NOPARAMETERS | Indica que esse item de criação não permite que nenhum parâmetro seja passado e falhará se algum for encontrado. Normalmente, os parâmetros de criação são passados para o manipulador de criação. Isso não pode ser usado com um sinalizador curinga. |
Observações
Um ponteiro para a estrutura KSOBJECT_CREATE_ITEM é colocado no DriverContext membro do Irp->Tail.Overlay antes de o objeto ser criado. Você pode acessar esse ponteiro usando a macro KSCREATE_ITEM_IRP_STORAGE. Essa macro e as macros relacionadas estão incluídas no ks.h.
O minidriver pode recuperar esse ponteiro ao criar um novo objeto para examinar o campo contexto de.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ks.h (incluir Ks.h) |