STORAGE_OFFLOAD_READ_OUTPUT structure

The STORAGE_OFFLOAD_READ_OUTPUT structure is the output of an IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES control code request when the Action member of DEVICE_MANAGE_DATA_SET_ATTRIBUTES is set to DeviceDsmAction_OffloadRead.

A returned token uniquely identifies the data set ranges requested in DEVICE_MANAGE_DATA_SET_ATTRIBUTES. In conjunction with DEVICE_MANAGE_DATA_SET_ATTRIBUTES, the DEVICE_DSM_OFFLOAD_READ_PARAMETERS structure specifies how long the data set ranges identified by the returned token remain available for subsequent writing.

Syntax


typedef struct _STORAGE_OFFLOAD_READ_OUTPUT {
  ULONG     OffloadReadFlags;
  ULONG     Reserved;
  ULONGLONG LengthProtected;
  ULONG     TokenLength;
  UCHAR     Token[DSM_OFFLOAD_MAX_TOKEN_LENGTH];
} STORAGE_OFFLOAD_READ_OUTPUT, *PSTORAGE_OFFLOAD_READ_OUTPUT;

Members

OffloadReadFlags

Not used. Set to 0.

Reserved

Reserved.

LengthProtected

The total length, in bytes, of data read and held by the copy provider for Token.

TokenLength

The length, in bytes, of Token.

Token

A unique identifier returned by the copy provider, marking the data set ranges that are read.

Remarks

The STORAGE_OFFLOAD_READ_OUTPUT structure is returned at the beginning of the system buffer.

The value for Token is generated by the copy provider of the storage device. The data set ranges included when the DEVICE_MANAGE_DATA_SET_ATTRIBUTES structure was sent in the IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES control code request are marked by Token. The data set ranges associated with Token are available for subsequent write requests while the duration in the TimeToLive member of DEVICE_DSM_OFFLOAD_READ_PARAMETERS is valid.

Requirements

Version

Available in Windows 8 and later versions of Windows.

Header

Ntddstor.h (include Ntddstor.h)

See also

DEVICE_DSM_OFFLOAD_READ_PARAMETERS
DEVICE_MANAGE_DATA_SET_ATTRIBUTES
IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft