estrutura FLT_VOLUME_PROPERTIES (fltkernel.h)

A estrutura FLT_VOLUME_PROPERTIES é passada como um parâmetro para FltGetVolumeProperties.

Sintaxe

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;

Membros

DeviceType

Recebe o tipo de dispositivo do volume. Deve ser um tipo de dispositivo de armazenamento válido, como um dos seguintes valores definidos em ntifs.h:

FILE_DEVICE_CD_ROM

FILE_DEVICE_DISK

FILE_DEVICE_DVD

FILE_DEVICE_MASS_STORAGE

FILE_DEVICE_NETWORK

FILE_DEVICE_VIRTUAL_DISK

Para obter mais informações, consulte Especificando tipos de dispositivo.

DeviceCharacteristics

Recebe as características do dispositivo do volume. Para obter mais informações, consulte a entrada de referência para IoCreateDevice.

DeviceObjectFlags

Recebe os sinalizadores de objeto do dispositivo para o volume. Para obter mais informações sobre esses sinalizadores, consulte as entradas de referência para IoRegisterFileSystem e DEVICE_OBJECT.

AlignmentRequirement

Recebe o alinhamento do buffer exigido pelo dispositivo subjacente. O valor deve ser um dos valores FILE_xxxx_ALIGNMENT definidos em ntifs.h. Para obter mais informações, consulte DEVICE_OBJECT e Inicializando um objeto device.

SectorSize

Recebe o tamanho do setor de volume, em bytes.

Flags

Fornece uma descrição adicional do volume. Esse membro pode ser zero ou um dos sinalizadores a seguir. Em versões anteriores a Windows 10, versão 1607, esse membro era nomeado Reservado0 e reservado para uso do sistema.

Valor Significado
VOL_PROP_FL_DAX_VOLUME
Esse sinalizador indica que o volume é um volume DEX (acesso direto).

FileSystemDriverName

UNICODE_STRING estrutura que recebe o nome do serviço do sistema de arquivos montado nesse volume. O buffer dessa cadeia de caracteres Unicode é contíguo com essa estrutura e não precisa ser inicializado antes de chamar FltGetVolumeProperties.

FileSystemDeviceName

UNICODE_STRING estrutura que recebe o nome do objeto de dispositivo do sistema de arquivos associado a esse volume. O buffer dessa cadeia de caracteres Unicode é contíguo com essa estrutura e não precisa ser inicializado antes de chamar FltGetVolumeProperties.

RealDeviceName

UNICODE_STRING estrutura que recebe o nome do objeto de dispositivo de armazenamento associado a esse volume. Essa estrutura está vazia para sistemas de arquivos de rede. O buffer dessa cadeia de caracteres Unicode é contíguo com essa estrutura e não precisa ser inicializado antes de chamar FltGetVolumeProperties.

Comentários

O armazenamento para a estrutura de FLT_VOLUME_PROPERTIES normalmente é alocado do pool paginado.

Para obter o nome do volume de um determinado volume, chame FltGetVolumeName.

Para obter o nome guid (identificador global exclusivo) do volume para um determinado volume, chame FltGetVolumeGuidName.

Requisitos

Requisito Valor
Cabeçalho fltkernel.h (inclua Fltkernel.h)

Confira também

DEVICE_OBJECT

FltGetVolumeName

FltGetVolumeProperties

IoCreateDevice

IoRegisterFileSystem

UNICODE_STRING