Função FltQueryVolumeInformationFile (fltkernel.h)

Artigo
08/07/2023

FltQueryVolumeInformationFile recupera informações de volume para um determinado arquivo, diretório, dispositivo de armazenamento ou volume.

Sintaxe

NTSTATUS FLTAPI FltQueryVolumeInformationFile(
  [in]            PFLT_INSTANCE        Instance,
  [in]            PFILE_OBJECT         FileObject,
  [out]           PVOID                FsInformation,
  [in]            ULONG                Length,
  [in]            FS_INFORMATION_CLASS FsInformationClass,
  [out, optional] PULONG               LengthReturned
);

Parâmetros

[in] Instance

Ponteiro de instância opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.

[in] FileObject

Ponteiro de objeto de arquivo para um arquivo aberto, diretório, dispositivo de armazenamento ou volume. Esse parâmetro é necessário e não pode ser NULL.

[out] FsInformation

Ponteiro para um buffer alocado pelo chamador que recebe informações sobre o arquivo. O parâmetro FsInformationClass especifica o tipo de informação. Esse parâmetro é necessário e não pode ser NULL.

[in] Length

Tamanho, em bytes, do buffer FsInformation .

[in] FsInformationClass

Tipo de informações de volume a serem retornadas. Um dos seguintes:

Valor	Significado
FileFsAttributeInformation	Retornar uma estrutura FILE_FS_ATTRIBUTE_INFORMATION que contém informações de atributo sobre o sistema de arquivos responsável pelo volume.
FileFsControlInformation	Retornar uma estrutura FILE_FS_CONTROL_INFORMATION que contém informações de controle do sistema de arquivos sobre o volume.
FileFsDeviceInformation	Retornar uma estrutura FILE_FS_DEVICE_INFORMATION que contém informações do dispositivo para o volume.
FileFsDriverPathInformation	Retornar uma estrutura de FILE_FS_DRIVER_PATH_INFORMATION que contém informações sobre se um driver especificado está no caminho de E/S para o volume. O chamador deve armazenar o nome do driver na estrutura FILE_FS_DRIVER_PATH_INFORMATION antes de chamar FltQueryVolumeInformationFile.
FileFsFullSizeInformation	Retornar uma estrutura de FILE_FS_FULL_SIZE_INFORMATION que contém informações sobre a quantidade total de espaço disponível no volume.
FileFsObjectIdInformation	Retornar uma estrutura FILE_FS_OBJECTID_INFORMATION que contém informações de ID de objeto específicas do sistema de arquivos para o volume. Observe que isso não é o mesmo que o nome de volume exclusivo (baseado em GUID) atribuído pelo sistema operacional.
FileFsSizeInformation	Retornar uma estrutura FILE_FS_SIZE_INFORMATION que contém informações sobre a quantidade de espaço no volume que está disponível para o usuário associado ao thread de chamada.
FileFsVolumeInformation	Retornar um FILE_FS_VOLUME_INFORMATION que contém informações sobre o volume, como o rótulo de volume, o número de série e o tempo de criação.
FileFsSectorSizeInformation	Retornar uma estrutura FILE_FS_SECTOR_SIZE_INFORMATION que contém informações sobre os tamanhos do setor físico e lógico de um volume.

[out, optional] LengthReturned

Ponteiro para uma variável alocada pelo chamador que recebe o tamanho, em bytes, das informações retornadas no buffer FsInformation . Esse parâmetro é opcional e pode ser NULL.

Retornar valor

FltQueryVolumeInformationFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno	Descrição
STATUS_VOLUME_DISMOUNTED	O volume não está montado no momento. Este é um código de erro.

Comentários

FltQueryVolumeInformationFile recupera informações de volume para um determinado arquivo, diretório, dispositivo de armazenamento ou volume.

Se o FileObject representar um dispositivo direto aberto, somente FileFsDeviceInformation poderá ser especificado como o valor de FsInformationClass.

FltQueryVolumeInformationFile retorna zero em qualquer membro de uma estrutura FILE_FS_XXX_INFORMATION que não é compatível com um sistema de arquivos específico.