Expand Minimize

FLT_VOLUME_PROPERTIES structure

The FLT_VOLUME_PROPERTIES structure is passed as a parameter to FltGetVolumeProperties.

Syntax


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

Members

DeviceType

Receives the device type of the volume. Must be a valid storage device type, such as one of the following values defined in ntifs.h:

FILE_DEVICE_CD_ROM

FILE_DEVICE_DISK

FILE_DEVICE_DVD

FILE_DEVICE_MASS_STORAGE

FILE_DEVICE_NETWORK

FILE_DEVICE_VIRTUAL_DISK

For more information, see Specifying Device Types.

DeviceCharacteristics

Receives the device characteristics of the volume. For more information, see the reference entry for IoCreateDevice.

DeviceObjectFlags

Receives the device object flags for the volume. For more information about these flags, see the reference entries for IoRegisterFileSystem and DEVICE_OBJECT.

AlignmentRequirement

Receives the buffer alignment required by the underlying device. The value must be one of the FILE_xxxx_ALIGNMENT values defined in ntifs.h. For more information, see DEVICE_OBJECT and Initializing a Device Object.

SectorSize

Receives the volume sector size, in bytes.

Reserved0

Reserved for system use.

FileSystemDriverName

UNICODE_STRING structure that receives the service name of the file system that is mounted on this volume. The buffer for this Unicode string is contiguous with this structure and does not need to be initialized before calling FltGetVolumeProperties.

FileSystemDeviceName

UNICODE_STRING structure that receives the name of the file system device object associated with this volume. The buffer for this Unicode string is contiguous with this structure and does not need to be initialized before calling FltGetVolumeProperties.

RealDeviceName

UNICODE_STRING structure that receives the name of the storage device object associated with this volume. This structure is empty for network file systems. The buffer for this Unicode string is contiguous with this structure and does not need to be initialized before calling FltGetVolumeProperties.

Remarks

Storage for the FLT_VOLUME_PROPERTIES structure is typically allocated from paged pool.

To get the volume name for a given volume, call FltGetVolumeName.

To get the volume globally unique identifier (GUID) name for a given volume, call FltGetVolumeGuidName.

Requirements

Header

Fltkernel.h (include Fltkernel.h)

See also

DEVICE_OBJECT
FltGetVolumeName
FltGetVolumeName
FltGetVolumeProperties
IoCreateDevice
IoRegisterFileSystem
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.