FLT_PARAMETERS para IRP_MJ_CREATE_NAMED_PIPE união

Artigo
03/14/2023

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

Sintaxe

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

Membros

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

Comentários

FLT_PARAMETERS contém uma estrutura CreatePipe quando a operação de E/S é IRP_MJ_CREATE_NAMED_PIPE. 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 para a 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_NAMED_PIPE deve executar qualquer processamento e retorno necessários.

Observe que, além do último campo de palavra longa, os campos na estrutura CreatePipe devem corresponder aos da estrutura Create .

IRP_MJ_CREATE_NAMED_PIPE é uma operação baseada em IRP.