FsRtlGetSectorSizeInformation function

The FsRtlGetSectorSizeInformation routine retrieves the physical and logical sector size information for a storage volume.

Syntax

NTSTATUS FsRtlGetSectorSizeInformation(
  _In_  PDEVICE_OBJECT                   RealDevice,
  _Out_ PFILE_FS_SECTOR_SIZE_INFORMATION SectorSizeInfo
);

Parameters

DeviceObject

TBD

SectorSizeInfo

A pointer to a caller supplied FILE_FS_SECTOR_SIZE_INFORMATION structure.

Return Value

FsRtlGetSectorSizeInformation returns STATUS_SUCCESS if the sector size information is returned in SectorSizeInfo. Otherwise, another appropriate NTSTATUS value is returned such as the following.

Return code Description
STATUS_BAD_DEVICE_TYPE
The storage device reported an invalid sector size.

Remarks

This routine is used by file system drivers to retrieve sector size information from the storage device containing the volume. A file system driver typically maintains the device object sent in RealDevice in its volume parameter block (VPD) for the storage volume.

Drivers other than file system drivers, can query sector size information using the FltQueryVolumeInformation or ZwQueryVolumeInformationFile routines, or by sending an IRP_MJ_QUERY_VOLUME_INFORMATION request and specifying FileFsSectorSizeInformation as the file system information class.

Requirements

   
Windows version Available in starting with Windows 8.
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

See Also

IRP_MJ_QUERY_VOLUME_INFORMATION

IRP_MJ_QUERY_VOLUME_INFORMATION

FILE_FS_SECTOR_SIZE_INFORMATION

FltQueryVolumeInformation

Send comments about this topic to Microsoft