What does HRESULT 0x8004254F (VDS_E_VOLUME_LENGTH_NOT_SECTOR_SIZE_MULTIPLE) mean?

 
Previous Next
VDS_E_INVALID_VOLUME_LENGTH VDS_E_VOLUME_NOT_RETAINED

VDS_E_VOLUME_LENGTH_NOT_SECTOR_SIZE_MULTIPLE

VDS validates volume geometry against the disk sector size. A byte length that is not an exact multiple of that size cannot describe a complete sequence of sectors and is rejected before the layout is committed. This is different from partition alignment at the beginning of a range: the failure concerns the volume length itself.

Why this state matters

Record the sector size for every contributing disk and the exact 64-bit requested length. Earlier VDS topology rules also require compatible sector sizes for disks holding extents of a given volume. Avoid decimal rounding or human-readable size conversions when constructing API arguments; calculate the remainder directly in bytes and derive a corrected length from the documented storage geometry.

Diagnostic focus

  • Capture the exact requested byte length and logical sector size.
  • Calculate length % sector_size before submitting the operation.
  • For multi-disk volumes, verify the contributing disks expose compatible sector sizes.
  • Do not substitute file-system cluster size for the disk sector size used by this geometry check.

Technical references

VDS_DISK_PROP · IVdsDisk::QueryExtents · VDS_PARTITION_PROP · IVdsPack2::CreateVolume2 · MS-VDS error codes


Looking for a different code? Search another status or error code.