Função FsRtlGetSectorSizeInformation (ntifs.h)

  • Artigo

A rotina FsRtlGetSectorSizeInformation recupera as informações de tamanho do setor físico e lógico para um volume de armazenamento.

Sintaxe

NTSTATUS FsRtlGetSectorSizeInformation(
        PDEVICE_OBJECT                   DeviceObject,
  [out] PFILE_FS_SECTOR_SIZE_INFORMATION SectorSizeInfo
);

Parâmetros

DeviceObject

O objeto de dispositivo de destino para um dispositivo de armazenamento.

[out] SectorSizeInfo

Um ponteiro para um chamador fornecido FILE_FS_SECTOR_SIZE_INFORMATION estrutura.

Retornar valor

FsRtlGetSectorSizeInformation retornará STATUS_SUCCESS se as informações de tamanho do setor forem retornadas em SectorSizeInfo. Caso contrário, outro valor NTSTATUS apropriado será retornado, como o seguinte.

Código de retorno Descrição
STATUS_BAD_DEVICE_TYPE
 O dispositivo de armazenamento relatou um tamanho de setor inválido.

Comentários

Essa rotina é usada por drivers do sistema de arquivos para recuperar informações de tamanho do setor do dispositivo de armazenamento que contém o volume. Um driver do sistema de arquivos normalmente mantém o objeto de dispositivo enviado em RealDevice em seu VPD (bloco de parâmetros de volume) para o volume de armazenamento.

Drivers diferentes de drivers do sistema de arquivos podem consultar informações de tamanho do setor usando as rotinas FltQueryVolumeInformation ou ZwQueryVolumeInformationFile ou enviando uma solicitação de IRP_MJ_QUERY_VOLUME_INFORMATION e especificando FileFsSectorSizeInformation como a classe de informações do sistema de arquivos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível em começando com Windows 8.
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Confira também

FILE_FS_SECTOR_SIZE_INFORMATION

FltQueryVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

ZwQueryVolumeInformationFile