FLT_VOLUME_PROPERTIES-Struktur (fltkernel.h)

Artikel
02/29/2024

Die FLT_VOLUME_PROPERTIES-Struktur wird als Parameter an FltGetVolumeProperties übergeben.

Syntax

typedef struct _FLT_VOLUME_PROPERTIES {
  DEVICE_TYPE    DeviceType;
  ULONG          DeviceCharacteristics;
  ULONG          DeviceObjectFlags;
  ULONG          AlignmentRequirement;
  USHORT         SectorSize;
  USHORT         Flags;
  UNICODE_STRING FileSystemDriverName;
  UNICODE_STRING FileSystemDeviceName;
  UNICODE_STRING RealDeviceName;
} FLT_VOLUME_PROPERTIES, *PFLT_VOLUME_PROPERTIES;

Member

DeviceType

Empfängt den Gerätetyp des Volumes. Muss ein gültiger Speichergerätetyp sein, z. B. einer der folgenden Werte, die in ntifs.h definiert sind:

FILE_DEVICE_CD_ROM

FILE_DEVICE_DISK

FILE_DEVICE_DVD

FILE_DEVICE_MASS_STORAGE

FILE_DEVICE_NETWORK

FILE_DEVICE_VIRTUAL_DISK

Weitere Informationen finden Sie unter Angeben von Gerätetypen.

DeviceCharacteristics

Empfängt die Gerätemerkmale des Volumes. Weitere Informationen finden Sie im Referenzeintrag für IoCreateDevice.

DeviceObjectFlags

Empfängt die Geräteobjektflags für das Volume. Weitere Informationen zu diesen Flags finden Sie in den Referenzeinträgen für IoRegisterFileSystem und DEVICE_OBJECT.

AlignmentRequirement

Empfängt die Pufferausrichtung, die vom zugrunde liegenden Gerät erforderlich ist. Der Wert muss einer der FILE_xxxx_ALIGNMENT-Werte sein, die in ntifs.h definiert sind. Weitere Informationen finden Sie unter DEVICE_OBJECT und Initialisieren eines Geräteobjekts.

SectorSize

Empfängt die Volumesektorgröße in Bytes.

Flags

Enthält eine zusätzliche Beschreibung des Volumes. Dieses Element kann null oder eines der folgenden Flags sein. In Versionen vor Windows 10, Version 1607, wurde dieser Member reserviert0 genannt und für die Systemverwendung reserviert.

Wert	Bedeutung
VOL_PROP_FL_DAX_VOLUME	Dieses Flag gibt an, dass es sich bei dem Volume um ein DAX-Volume (Direct Access) handelt.

FileSystemDriverName

UNICODE_STRING Struktur, die den Dienstnamen des Dateisystems empfängt, das auf diesem Volume eingebunden ist. Der Puffer für diese Unicode-Zeichenfolge ist mit dieser Struktur zusammenhängend und muss nicht initialisiert werden, bevor FltGetVolumeProperties aufgerufen wird.

FileSystemDeviceName

UNICODE_STRING Struktur, die den Namen des Diesem Volume zugeordneten Dateisystemgeräteobjekts empfängt. Der Puffer für diese Unicode-Zeichenfolge ist mit dieser Struktur zusammenhängend und muss nicht initialisiert werden, bevor FltGetVolumeProperties aufgerufen wird.

RealDeviceName

UNICODE_STRING Struktur, die den Namen des diesem Volume zugeordneten Speichergeräteobjekts empfängt. Diese Struktur ist für Netzwerkdateisysteme leer. Der Puffer für diese Unicode-Zeichenfolge ist mit dieser Struktur zusammenhängend und muss nicht initialisiert werden, bevor FltGetVolumeProperties aufgerufen wird.

Hinweise

Der Speicher für die FLT_VOLUME_PROPERTIES-Struktur wird in der Regel aus einem ausgelagerten Pool zugeordnet.

Um den Volumenamen für ein bestimmtes Volume abzurufen, rufen Sie FltGetVolumeName auf.

Rufen Sie FltGetVolumeGuidName auf, um den GUID-Namen (Globally Unique Identifier) des Volumes für ein bestimmtes Volume abzurufen.

Anforderungen

Anforderung	Wert
Header	fltkernel.h (include Fltkernel.h)

Weitere Informationen

DEVICE_OBJECT

FltGetVolumeName

FltGetVolumeProperties

IoCreateDevice

IoRegisterFileSystem

UNICODE_STRING

Share via