FLT_PARAMETERS para união IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION

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_ACQUIRE_FOR_SECTION_SYNCHRONIZATION.

Sintaxe

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    FS_FILTER_SECTION_SYNC_TYPE SyncType;
    ULONG POINTER_ALIGNMENT     PageProtection;
    PFS_FILTER_SECTION_SYNC_OUTPUT OutputInformation;
  } AcquireForSectionSynchronization;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Membros

SyncType: o tipo de sincronização solicitado para a seção. Esse parâmetro será definido como SyncTypeCreateSection se uma seção estiver sendo criada; caso contrário, ele será definido como SyncTypeOther.
PageProtection: o tipo de proteção de página solicitada para a seção. Deve ser zero se SyncType for SyncTypeOther. Caso contrário, esse parâmetro deve ser um dos valores de constante de proteção de memória definidos.
OutputInformation: uma estrutura FS_FILTER_SECTION_SYNC_OUTPUT que especifica informações que descrevem os atributos da seção que está sendo criada.

Comentários

A estrutura FLT_PARAMETERS para operações de IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION contém os parâmetros de uma operação AcquireForSectionSynchronization 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_ACQUIRE_FOR_SECTION_SYNCHRONIZATION é uma operação de retorno de chamada do FSFilter (sistema de arquivos).

Se o valor enumerado do membro SyncType estiver definido como SyncTypeOther, um minifiltro do sistema de arquivos ou um driver de filtro herdado não poderá falhar nesta operação. Se SyncType estiver definido como SyncTypeCreateSection, um minifiltro do sistema de arquivos ou um driver de filtro herdado poderá falhar com um erro de STATUS_INSUFFICIENT_RESOURCES se não houver memória suficiente para criar a seção.

Para obter mais informações sobre operações de retorno de chamada FSFilter, consulte a entrada de referência para FsRtlRegisterFileSystemFilterCallbacks.