Edit

DEVICE_DSM_OFFLOAD_READ_PARAMETERS structure (ntddstor.h)

  • Article

The DEVICE_DSM_OFFLOAD_READ_PARAMETERS structure specifies the parameters for an offload read action related to the data-set attributes for a device.

Syntax

typedef struct _DEVICE_DSM_OFFLOAD_READ_PARAMETERS {
  ULONG Flags;
  ULONG TimeToLive;
  ULONG Reserved[2];
} DEVICE_DSM_OFFLOAD_READ_PARAMETERS, *PDEVICE_DSM_OFFLOAD_READ_PARAMETERS;

Members

Flags

Not used. Set to 0.

TimeToLive

The duration, in milliseconds, for which the requested data ranges should remain valid.

Reserved[2]

Reserved.

Remarks

This structure is used in an offload read action for an IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES request. The Action member of the DEVICE_DSM_INPUT structure is set to DeviceDsmAction_OffloadRead.

The ParameterBlockOffset and ParameterBlockLength members of DEVICE_DSM_INPUT structure are set to the location and length of the DEVICE_DSM_OFFLOAD_READ_PARAMETERS structure in the input buffer of the IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES request.

The DataSetRangesOffset and DataSetRangesLength members of DEVICE_DSM_INPUT specify the DEVICE_DSM_RANGE structures for the extents of the offload read.

See DEVICE_DSM_ACTION Descriptions for more details about this action.

Requirements

Requirement Value
Minimum supported client Available in Windows 8 and later versions of Windows.
Header ntddstor.h (include Ntddstor.h)

See also

DEVICE_DSM_ACTION Descriptions

DEVICE_DSM_INPUT

DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS

DEVICE_DSM_RANGE