Compartilhar via


FLT_PARAMETERS para união IRP_MJ_CREATE_MAILSLOT

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.

Requisitos

Tipo de Requisito Requisito
parâmetro Fltkernel.h (inclua Fltkernel.h)

Confira também

ACCESS_MASK

ACCESS_STATE

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FLT_PARAMETERS

FltCreateMailslotFile

IRP_MJ_CREATE_MAILSLOT

MAILSLOT_CREATE_PARAMETERS