Função FsRtlGetSectorSizeInformation (ntifs.h)

Artigo
12/21/2024

A rotina de FsRtlGetSectorSizeInformation recupera as informações de tamanho do setor físico e lógico de 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.

Valor de retorno

FsRtlGetSectorSizeInformation retornará STATUS_SUCCESS se as informações de tamanho do setor forem retornadas noSectorSizeInfo . 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.

Observações

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âmetro 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 rotinas ou enviando uma solicitação IRP_MJ_QUERY_VOLUME_INFORMATION e especificando FileFsSectorSizeInformation como a classe de informações do sistema de arquivos.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível para começar com o Windows 8.
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte também

FILE_FS_SECTOR_SIZE_INFORMATION

FltQueryVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

Compartilhar via