estrutura FILE_FS_SIZE_INFORMATION (ntddk.h)

Artigo
02/26/2024

A estrutura FILE_FS_SIZE_INFORMATION é usada para consultar informações de tamanho do setor para um volume do sistema de arquivos.

Sintaxe

typedef struct _FILE_FS_SIZE_INFORMATION {
  LARGE_INTEGER TotalAllocationUnits;
  LARGE_INTEGER AvailableAllocationUnits;
  ULONG         SectorsPerAllocationUnit;
  ULONG         BytesPerSector;
} FILE_FS_SIZE_INFORMATION, *PFILE_FS_SIZE_INFORMATION;

Membros

TotalAllocationUnits

Número total de unidades de alocação no volume que estão disponíveis para o usuário associado ao thread de chamada.

Microsoft Windows 2000 e posterior: Se as cotas por usuário estiverem em uso, esse valor poderá ser menor que o número total de unidades de alocação no disco.

AvailableAllocationUnits

Número total de unidades de alocação gratuitas no volume que estão disponíveis para o usuário associado ao thread de chamada.

Windows 2000 e posterior: Se as cotas por usuário estiverem em uso, esse valor poderá ser menor que o número total de unidades de alocação gratuitas no disco.

SectorsPerAllocationUnit

Número de setores em cada unidade de alocação.

BytesPerSector

Número de bytes em cada setor.

Comentários

Essas informações podem ser consultadas de qualquer uma das seguintes maneiras:

Chame FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, passando FileFsSizeInformation como o valor de FileInformationClass e passando um buffer alocado pelo chamador FILE_FS_SIZE_INFORMATION estruturado como o valor de FileInformation.
Crie um IRP com o código de função principal IRP_MJ_QUERY_VOLUME_INFORMATION.

Nenhum direito de acesso específico é necessário para consultar essas informações. Portanto, essas informações estão disponíveis desde que o volume seja acessado por meio de um identificador aberto para o próprio volume ou para um arquivo ou diretório no volume.

O tamanho do buffer passado no parâmetro FileInformation para FltQueryVolumeInformation ou ZwQueryVolumeInformationFile deve ser pelo menos sizeof (FILE_FS_SIZE_INFORMATION).

Essa estrutura deve ser alinhada em um limite LONGLONG (8 bytes).

Requisitos

Requisito	Valor
Cabeçalho	ntddk.h (inclua Ntddk.h, Ntifs.h, Fltkernel.h)

Confira também

FltQueryVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

Compartilhar via