struttura FLT_VOLUME_PROPERTIES (fltkernel.h)

  • Articolo

La struttura FLT_VOLUME_PROPERTIES viene passata come parametro a FltGetVolumeProperties.

Sintassi

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;

Members

DeviceType

Riceve il tipo di dispositivo del volume. Deve essere un tipo di dispositivo di archiviazione valido, ad esempio uno dei valori seguenti definiti in ntifs.h:

FILE_DEVICE_CD_ROM

FILE_DEVICE_DISK

FILE_DEVICE_DVD

FILE_DEVICE_MASS_STORAGE

FILE_DEVICE_NETWORK

FILE_DEVICE_VIRTUAL_DISK

Per altre informazioni, vedere Specifica dei tipi di dispositivo.

DeviceCharacteristics

Riceve le caratteristiche del dispositivo del volume. Per altre informazioni, vedere la voce di riferimento per IoCreateDevice.

DeviceObjectFlags

Riceve i flag dell'oggetto dispositivo per il volume. Per altre informazioni su questi flag, vedere le voci di riferimento per IoRegisterFileSystem e DEVICE_OBJECT.

AlignmentRequirement

Riceve l'allineamento del buffer richiesto dal dispositivo sottostante. Il valore deve essere uno dei valori FILE_xxxx_ALIGNMENT definiti in ntifs.h. Per altre informazioni, vedere DEVICE_OBJECT e Inizializzazione di un oggetto Device.

SectorSize

Riceve le dimensioni del settore del volume, in byte.

Flags

Fornisce una descrizione aggiuntiva del volume. Questo membro può essere zero o uno dei flag seguenti. Nelle versioni precedenti a Windows 10, versione 1607, questo membro è stato denominato Reserved0 e riservato per l'uso del sistema.

Valore Significato
VOL_PROP_FL_DAX_VOLUME
 Questo flag indica che il volume è un volume DAX (Direct Access).

FileSystemDriverName

UNICODE_STRING struttura che riceve il nome del servizio del file system montato in questo volume. Il buffer per questa stringa Unicode è contiguo a questa struttura e non deve essere inizializzato prima di chiamare FltGetVolumeProperties.

FileSystemDeviceName

UNICODE_STRING struttura che riceve il nome dell'oggetto dispositivo del file system associato a questo volume. Il buffer per questa stringa Unicode è contiguo a questa struttura e non deve essere inizializzato prima di chiamare FltGetVolumeProperties.

RealDeviceName

UNICODE_STRING struttura che riceve il nome dell'oggetto dispositivo di archiviazione associato a questo volume. Questa struttura è vuota per i file system di rete. Il buffer per questa stringa Unicode è contiguo a questa struttura e non deve essere inizializzato prima di chiamare FltGetVolumeProperties.

Commenti

L'archiviazione per la struttura FLT_VOLUME_PROPERTIES viene in genere allocata dal pool di paging.

Per ottenere il nome del volume per un determinato volume, chiamare FltGetVolumeName.

Per ottenere il nome dell'identificatore univoco globale (GUID) del volume per un determinato volume, chiamare FltGetVolumeGuidName.

Requisiti

Requisito Valore
Intestazione fltkernel.h (include Fltkernel.h)

Vedi anche

DEVICE_OBJECT

FltGetVolumeName

FltGetVolumeProperties

IoCreateDevice

IoRegisterFileSystem

UNICODE_STRING