DEVICE_DSM_RANGE_ERROR_INFO structure (ntddstor.h)

The DEVICE_DSM_RANGE_ERROR_OUTPUT (or DEVICE_DSM_RANGE_ERROR_INFO) structure stores information about whether one or more logical block ranges contain any media errors.

Syntax

typedef struct _DEVICE_DSM_RANGE_ERROR_INFO {
  ULONG                           Version;
  ULONG                           Flags;
  ULONG                           TotalNumberOfRanges;
  ULONG                           NumberOfRangesReturned;
  DEVICE_STORAGE_RANGE_ATTRIBUTES Ranges[ANYSIZE_ARRAY];
} DEVICE_DSM_RANGE_ERROR_INFO, *PDEVICE_DSM_RANGE_ERROR_INFO, DEVICE_DSM_RANGE_ERROR_OUTPUT, *PDEVICE_DSM_RANGE_ERROR_OUTPUT;

Members

Version

Version of this structure. Set to sizeof(DEVICE_DSM_RANGE_ERROR_OUTPUT).

Flags

Flags associated with the range error information. Possible values are:

Value Meaning
DEVICE_STORAGE_NO_ERRORS There are no media errors in any of the requested ranges.

TotalNumberOfRanges

Number of DEVICE_STORAGE_RANGE_ATTRIBUTES structure(s) needed to satisfy a DeviceDsmAction_GetRangeErrorInfo request.

NumberOfRangesReturned

Number of DEVICE_STORAGE_RANGE_ATTRIBUTES structures returned in Ranges.

Ranges[ANYSIZE_ARRAY]

Array of DEVICE_STORAGE_RANGE_ATTRIBUTES structure(s) in which to return media error information.

Remarks

The output block in the payload of an IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES request is formatted as a DEVICE_DSM_RANGE_ERROR_OUTPUT structure when the action is DeviceDsmAction_GetRangeErrorInfo. See DEVICE_DSM_ACTION Descriptions for more details about this action.

Requirements

Requirement Value
Header ntddstor.h

See also

DEVICE_DSM_ACTION Descriptions

DEVICE_STORAGE_RANGE_ATTRIBUTES

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES