2.3.60 FSCTL_QUERY_SPARING_INFO Reply
This message returns the results of the FSCTL_QUERY_SPARING_INFO request (section 2.3.59) as a FSCTL_QUERY_SPARING_BUFFER structure.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
SparingUnitBytes |
|||||||||||||||||||||||||||||||
|
SoftwareSparing |
Reserved |
||||||||||||||||||||||||||||||
|
TotalSpareBlocks |
|||||||||||||||||||||||||||||||
|
FreeSpareBlocks |
|||||||||||||||||||||||||||||||
SparingUnitBytes (4 bytes): A 32-bit unsigned integer that contains the size, in bytes, of a sparing packet, which is the same as the underlying error check and correction (ECC) block size of the media. For more information, see [UDF].
SoftwareSparing (1 byte): A Boolean (section 2.1.8) value. If TRUE, indicates that sparing behavior is software-based; if FALSE, it is hardware-based.
Reserved (3 bytes): A 24-bit reserved value. This field SHOULD be set to zero and MUST be ignored.
TotalSpareBlocks (4 bytes): A 32-bit unsigned integer that contains the total number of blocks allocated for sparing.
FreeSpareBlocks (4 bytes): A 32-bit unsigned integer that contains the number of blocks available for sparing.
This message returns a status code as specified in section 2.2. Upon success, the status code returned 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 |
An invalid parameter was passed to a service or function, or the buffer is too small to contain the entry. |