FLT_PARAMETERS per l'unione IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION

Articolo
02/07/2024

Il componente di unione seguente viene utilizzato quando il campo MajorFunction della struttura FLT_IO_PARAMETER_BLOCK per l'operazione viene IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION.

Sintassi

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;

Members

SyncType: tipo di sincronizzazione richiesto per la sezione. Questo parametro è impostato su SyncTypeCreateSection se viene creata una sezione; in caso contrario, è impostato su SyncTypeOther.
PageProtection: tipo di protezione delle pagine richiesto per la sezione. Deve essere zero se SyncType è SyncTypeOther . In caso contrario, questo parametro deve essere uno dei valori costanti di protezione della memoria definiti.
OutputInformation: struttura FS_FILTER_SECTION_SYNC_OUTPUT che specifica le informazioni che descrivono gli attributi della sezione da creare.

Commenti

La struttura FLT_PARAMETERS per IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION operazioni contiene i parametri per un'operazione AcquireForSectionSynchronization rappresentata da una struttura di dati di callback (FLT_CALLBACK_DATA). È contenuto in una struttura FLT_IO_PARAMETER_BLOCK.

IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION è un'operazione di callback del file system (FSFilter).

Se il valore enumerato del membro SyncType è impostato su SyncTypeOther, un minifilter del file system o un driver di filtro legacy non può avere esito negativo per questa operazione. Se SyncType è impostato su SyncTypeCreateSection, è consentito che un minifilter del file system o un driver di filtro legacy non riesca con un errore di STATUS_INSUFFICIENT_RESOURCES se non è disponibile memoria sufficiente per creare la sezione.

Per altre informazioni sulle operazioni di callback FSFilter, vedere la voce di riferimento per FsRtlRegisterFileSystemFilterCallbacks.