FLT_PARAMETERS para união IRP_MJ_CREATE_MAILSLOT

Artigo
02/02/2024

A estrutura a seguir dentro da união FLT_PARAMETERS é usada quando o campo MajorFunction da estrutura FLT_IO_PARAMETER_BLOCK é IRP_MJ_CREATE_MAILSLOT.

Sintaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIO_SECURITY_CONTEXT     SecurityContext;
    ULONG                    Options;
    USHORT POINTER_ALIGNMENT Reserved;
    USHORT                   ShareAccess;
    PVOID                    Parameters;
  } CreateMailslot;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membros

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

SecurityContext: ponteiro para uma estrutura de IO_SECURITY_CONTEXT que representa o contexto de segurança de uma solicitação de IRP_MJ_CREATE_MAILSLOT, 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 maillot. Para obter mais informações, consulte o parâmetro DesiredAccess de FltCreateMailslotFile.
Opções: bitmask de sinalizadores que especificam as opções a serem aplicadas ao criar ou abrir o maillot, bem como a ação a ser tomada se o maillot já existir. Os 24 bits baixos desse membro correspondem ao parâmetro CreateOptions para FltCreateMailslotFile. Os 8 bits altos correspondem ao parâmetro CreateDisposition para FltCreateMailslotFile.
Reservado: Reservado; não use.
ShareAccess: bitmask de direitos de acesso de compartilhamento solicitados para o arquivo maillot. Se esse parâmetro for zero, o acesso exclusivo será solicitado. Para obter mais informações, consulte o parâmetro ShareAccess para FltCreateMailslotFile.
Parâmetros: ponteiro para uma estrutura MAILSLOT_CREATE_PARAMETERS que contém informações sobre o maillot que está sendo criado ou aberto.

Comentários

FLT_PARAMETERS contém uma estrutura CreateMailslot quando a operação de E/S é IRP_MJ_CREATE_MAILSLOT. A operação de E/S é representada por uma estrutura FLT_CALLBACK_DATA , com os parâmetros de operação contidos na estrutura FLT_IO_PARAMETER_BLOCK à qual o parâmetro Iopb dos dados de retorno de chamada aponta.

Um driver de minifiltro do sistema de arquivos que registrou uma rotina de retorno de chamada para operações de IRP_MJ_CREATE_MAILSLOT deve executar qualquer processamento e retorno necessários.

Observe que, além do último campo longword, os campos na estrutura CreateMailslot devem corresponder aos da estrutura Criar .

IRP_MJ_CREATE_MAILSLOT é uma operação baseada em IRP.