Freigeben über


FLT_VOLUME_PROPERTIES Struktur (fltkernel.h)

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;

Angehörige

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äteobjektkennzeichnungen 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 vom zugrunde liegenden Gerät erforderliche Pufferausrichtung. Der Wert muss einer der in ntifs.h definierten FILE_xxxx_ALIGNMENT Werte sein. Weitere Informationen finden Sie unter DEVICE_OBJECT und Initialisieren eines Device Object.

SectorSize

Empfängt die Volumensektorgröße in Byte.

Flags

Stellt zusätzliche Beschreibung des Volumes bereit. Dieses Element kann null oder eines der folgenden Flags sein. In Versionen vor Windows 10, Version 1607, wurde dieses Mitglied Reserviert0 und für die Systemverwendung reserviert.

Wert Bedeutung
VOL_PROP_FL_DAX_VOLUME
Dieses Flag gibt an, dass das Volume ein DAX-Volume (Direct Access) ist.

FileSystemDriverName

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

FileSystemDeviceName

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

RealDeviceName

UNICODE_STRING Struktur, die den Namen des diesem Volume zugeordneten Speichergerätobjekts 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 FltGetVolumePropertiesaufgerufen wird.

Bemerkungen

Speicher für die FLT_VOLUME_PROPERTIES-Struktur wird in der Regel aus seitenseitigem Pool zugewiesen.

Rufen Sie FltGetVolumeNameauf, um den Volumenamen für ein bestimmtes Volume abzurufen.

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

Anforderungen

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

Siehe auch

DEVICE_OBJECT

FltGetVolumeName

FltGetVolumeProperties

IoCreateDevice

IoRegisterFileSystem-

UNICODE_STRING