2.3.24 FSCTL_GET_REFS_VOLUME_DATA Reply
The FSCTL_GET_REFS_VOLUME_DATA reply message returns the results of the FSCTL_GET_REFS_VOLUME_DATA request as an REFS_VOLUME_DATA_BUFFER element.
The REFS_VOLUME_DATA_BUFFER contains information on a volume.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ByteCount |
|||||||||||||||||||||||||||||||
|
MajorVersion |
|||||||||||||||||||||||||||||||
|
MinorVersion |
|||||||||||||||||||||||||||||||
|
BytesPerPhysicalSector |
|||||||||||||||||||||||||||||||
|
VolumeSerialNumber |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
NumberSectors |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
TotalClusters |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
FreeClusters |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
TotalReserved |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
BytesPerSector |
|||||||||||||||||||||||||||||||
|
BytesPerCluster |
|||||||||||||||||||||||||||||||
|
MaximumSizeOfResidentFile |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
Reserved (80 bytes) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
ByteCount (4 bytes): A 32-bit unsigned integer that contains the valid data length for this structure. ByteCount can be less than the size of this structure. Only the fields that entirely fit within the valid data length for this structure, as defined by ByteCount, are valid.
MajorVersion (4 bytes): A 32-bit unsigned integer that contains the major version of the ReFS volume.
MinorVersion (4 bytes): A 32-bit unsigned integer that contains the minor version of the ReFS volume.
BytesPerPhysicalSector (4 bytes): A 32-bit unsigned integer that defines the number of bytes in a physical sector on the specified volume.
VolumeSerialNumber (8 bytes): A 64-bit signed integer that contains the serial number of the volume. This is a unique number assigned to the volume media by the operating system when the volume is formatted.
NumberSectors (8 bytes): A 64-bit signed integer that contains the number of sectors in the specified volume.
TotalClusters (8 bytes): A 64-bit signed integer that contains the total number of clusters in the specified volume.
FreeClusters (8 bytes): A 64-bit signed integer that contains the number of free clusters in the specified volume.
TotalReserved (8 bytes): A 64-bit signed integer that contains the number of reserved clusters in the specified volume. Reserved clusters are used to guarantee clusters are available at points when the file system can't properly report allocation failures.
BytesPerSector (4 bytes): A 32-bit unsigned integer that contains the number of bytes in a sector on the specified volume.
BytesPerCluster (4 bytes): A 32-bit unsigned integer that contains the number of bytes in a cluster on the specified volume. This value is also known as the cluster factor.
MaximumSizeOfResidentFile (8 bytes): A 64-bit unsigned integer that defines the maximum number of bytes a file can contain and be co-located with the file system metadata that describes the file (commonly known as resident files).
Reserved (80 bytes): 80 bytes which, if included, as per the ByteCount field, are reserved, have an undefined value, and are not interpreted.
This message also returns a status code as specified in section 2.2. Upon success, the status code returned directly by the function that processes this FSCTL is STATUS_SUCCESS. The most common error codes are listed in the following table.
|
Error code |
Meaning |
|---|---|
|
STATUS_INVALID_PARAMETER 0xC000000D |
The handle specified is not open. |
|
STATUS_VOLUME_DISMOUNTED 0xC000026E |
The specified volume is no longer mounted. |
|
STATUS_BUFFER_TOO_SMALL 0xC0000023 |
The output buffer is too small to contain a REFS_VOLUME_DATA_BUFFER structure. |