FLT_PARAMETERS für IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION Union

Artikel
02/02/2024

Die folgende Union-Komponente wird verwendet, wenn das Feld MajorFunction der FLT_IO_PARAMETER_BLOCK-Struktur für den Vorgang IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION ist.

Syntax

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;

Member

SyncType: Der Typ der für den Abschnitt angeforderten Synchronisierung. Dieser Parameter ist auf SyncTypeCreateSection festgelegt, wenn ein Abschnitt erstellt wird. Andernfalls ist er auf SyncTypeOther festgelegt.
PageProtection: Der Typ des Seitenschutzes, der für den Abschnitt angefordert wird. Muss null sein, wenn SyncType syncTypeOther ist. Andernfalls muss dieser Parameter einer der definierten Speicherschutzkonstantenwerte sein.
OutputInformation: Eine FS_FILTER_SECTION_SYNC_OUTPUT-Struktur , die Informationen angibt, die die Attribute des zu erstellenden Abschnitts beschreiben.

Hinweise

Die FLT_PARAMETERS-Struktur für IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION-Vorgänge enthält die Parameter für einen AcquireForSectionSynchronization-Vorgang , der durch eine Rückrufdatenstruktur (FLT_CALLBACK_DATA) dargestellt wird. Sie ist in einer FLT_IO_PARAMETER_BLOCK-Struktur enthalten.

IRP_MJ_ACQUIRE_FOR_SECTION_SYNCHRONIZATION ist ein Dateisystem-Rückrufvorgang (FSFilter).

Wenn der enumerierte Wert des SyncType-Elements auf SyncTypeOther festgelegt ist, kann dieser Vorgang bei einem Dateisystem-Minifilter oder legacy-Filtertreiber nicht fehlschlagen. Wenn SyncType auf SyncTypeCreateSection festgelegt ist, kann ein Dateisystem-Minifilter oder Legacyfiltertreiber mit einem STATUS_INSUFFICIENT_RESOURCES Fehler fehlschlagen, wenn nicht genügend Arbeitsspeicher zum Erstellen des Abschnitts vorhanden ist.

Weitere Informationen zu FSFilter-Rückrufvorgängen finden Sie im Referenzeintrag für FsRtlRegisterFileSystemFilterCallbacks.