Skip to content

flt-parameters-for-irp-mj-acquire-for-section-synchronization.md

Latest commit

 

History

History
84 lines (57 loc) · 4.78 KB

flt-parameters-for-irp-mj-acquire-for-section-synchronization.md

File metadata and controls

84 lines (57 loc) · 4.78 KB
title FLT_PARAMETERS for IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION Union
description The following union component is used when the MajorFunction field of the FLT_IO_PARAMETER_BLOCK structure for the operation is IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION.
keywords
FLT_PARAMETERS for IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION union Installable File System Drivers
FLT_PARAMETERS union Installable File System Drivers
PFLT_PARAMETERS union pointer Installable File System Drivers
topic_type
apiref
api_name
FLT_PARAMETERS
api_location
fltkernel.h
api_type
HeaderDef
ms.date 03/13/2023
ms.topic reference

FLT_PARAMETERS for IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION union

The following union component is used when the MajorFunction field of the FLT_IO_PARAMETER_BLOCK structure for the operation is IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION.

Syntax

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

Members

  • SyncType: The type of synchronization requested for the section. This parameter is set to SyncTypeCreateSection if a section is being created; otherwise, it is set to SyncTypeOther.

  • PageProtection: The type of page protection requested for the section. Must be zero if SyncType is SyncTypeOther. Otherwise, this parameter must be one of the defined memory protection constant values.

  • OutputInformation: A FS_FILTER_SECTION_SYNC_OUTPUT structure that specifies information describing the attributes of the section that is being created.

  • Flags: Bitmask of flags providing additional information or instructions about the section.

    Flag Meaning
    FS_FILTER_SECTION_SYNC_IN_FLAG_DONT_UPDATE_LAST_ACCESS
    0x00000001    		 Specifies that the file system shouldn't update the last access time for access to the file through the section that's being created.
    FS_FILTER_SECTION_SYNC_IN_FLAG_DONT_UPDATE_LAST_WRITE
    0x00000002    		 Specifies that the file system shouldn't update the last write time for modifications to the file through the section that's being created.

  • AllocationAttributes: Specifies a bitmask of SEC_XXX flags that determines the allocation attributes of the section. For a description of these flags, see CreateFileMapping.

    Note that SEC_IMAGE_NO_EXECUTE will not appear in this field. All image sections are indicated by the flag SEC_IMAGE.

Remarks

The FLT_PARAMETERS structure for IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION operations contains the parameters for an AcquireForSectionSynchronization operation represented by a callback data (FLT_CALLBACK_DATA) structure. It is contained in an FLT_IO_PARAMETER_BLOCK structure.

IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION is a file system (FSFilter) callback operation.

If the enumerated value of the SyncType member is set to SyncTypeOther, a file system minifilter or legacy filter driver cannot fail this operation. If SyncType is set to SyncTypeCreateSection, a file system minifilter or legacy filter driver is allowed to fail with a STATUS_INSUFFICIENT_RESOURCES error if there is not enough memory to create the section.

For more information about FSFilter callback operations, see the reference entry for FsRtlRegisterFileSystemFilterCallbacks.

Requirements

Version: Available in Windows XP and later versions of the Windows operating system.

Requirement type Requirement
Header Fltkernel.h (include Fltkernel.h)

See also

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FLT_PARAMETERS

FsRtlRegisterFileSystemFilterCallbacks