FLT_PARAMETERS para IRP_MJ_CREATE união

Artigo
02/02/2024

O componente de união a seguir é usado quando o campo MajorFunction da estrutura FLT_IO_PARAMETER_BLOCK para a operação é IRP_MJ_CREATE.

Sintaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIO_SECURITY_CONTEXT     SecurityContext;
    ULONG                    Options;
    USHORT POINTER_ALIGNMENT FileAttributes;
    USHORT                   ShareAccess;
    USHORT POINTER_ALIGNMENT EaLength;
    PVOID                    EaBuffer;
    LARGE_INTEGER            AllocationSize;
  } Create;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membros

A estrutura Create de FLT_PARAMETERS contém os membros a seguir.

SecurityContext: ponteiro para uma estrutura IO_SECURITY_CONTEXT que representa o contexto de segurança de uma solicitação de IRP_MJ_CREATE, em que:

Securitycontext->AccessState é um ponteiro para uma estrutura ACCESS_STATE que contém o contexto de assunto do objeto, os tipos de acesso concedidos e os tipos de acesso desejados restantes.
Securitycontext->DesiredAccess é uma estrutura ACCESS_MASK que especifica os direitos de acesso solicitados para o arquivo. Para obter mais informações, consulte o parâmetro DesiredAccess para FltCreateFile.
Opções: bitmask de sinalizadores que especificam as opções a serem aplicadas ao criar ou abrir o arquivo, bem como a ação a ser executada se o arquivo já existir. Os 24 bits baixos desse membro correspondem ao parâmetro CreateOptions para FltCreateFile. Os 8 bits altos correspondem ao parâmetro CreateDisposition para FltCreateFile.
FileAttributes: bitmask de atributos a serem aplicados ao criar ou abrir o arquivo. Para obter mais informações, consulte o parâmetro FileAttributes para FltCreateFile.
ShareAccess: bitmask dos direitos de acesso de compartilhamento solicitados para o arquivo. Se esse parâmetro for zero, o acesso exclusivo será solicitado. Para obter mais informações, consulte o parâmetro ShareAccess para FltCreateFile.
EaLength: comprimento, em bytes, do buffer para o qual o membro EaBuffer aponta. Para obter mais informações, consulte o parâmetro EaLength para FltCreateFile.
EaBuffer: ponteiro para um buffer estruturado por FILE_FULL_EA_INFORMATION fornecido pelo chamador que contém informações de EA (atributo estendido) a serem aplicadas ao arquivo. Para obter mais informações, consulte o parâmetro EaBuffer para FltCreateFile.
AllocationSize: opcionalmente especifica o tamanho da alocação inicial, em bytes, para o arquivo. Um valor diferente de zero não tem efeito, a menos que o arquivo esteja sendo criado, substituído ou substituído. Para obter mais informações, consulte o parâmetro AllocationSize para FltCreateFile.

Comentários

A estrutura FLT_PARAMETERS para a operação de IRP_MJ_CREATE contém os parâmetros para uma operação Create baseada em IRP representada por uma estrutura de dados de retorno de chamada (FLT_CALLBACK_DATA). Ele está contido em uma estrutura FLT_IO_PARAMETER_BLOCK .

IRP_MJ_CREATE é uma operação baseada em IRP.