STORAGE_OFFLOAD_READ_OUTPUT構造体 (ntddstor.h)
STORAGE_OFFLOAD_READ_OUTPUT構造体は、DEVICE_DSM_INPUT 構造体の Action メンバーが DeviceDsmAction_OffloadReadに設定されている場合の、IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES コントロール コード要求の出力です。
返されたトークンは、DEVICE_DSM_INPUTで要求されたデータ セット範囲を一意に識別します。 DEVICE_DSM_INPUTと組み合わせて、DEVICE_DSM_OFFLOAD_READ_PARAMETERS 構造体は、返されたトークンによって識別されるデータ セット範囲が後続の書き込みに使用できる期間を指定します。
構文
typedef struct _STORAGE_OFFLOAD_READ_OUTPUT {
ULONG OffloadReadFlags;
ULONG Reserved;
ULONGLONG LengthProtected;
ULONG TokenLength;
STORAGE_OFFLOAD_TOKEN Token;
} STORAGE_OFFLOAD_READ_OUTPUT, *PSTORAGE_OFFLOAD_READ_OUTPUT;
メンバーズ
OffloadReadFlags
使用されません。 0 に設定します。
Reserved
引っ込み思案。
LengthProtected
トークンのコピー プロバイダーが読み取って保持するデータの合計長 (バイト単位)。
TokenLength
トークンの長さ (バイト単位)。
Token
コピー プロバイダーによって返される一意の識別子。読み取られたデータ セットの範囲をマークします。
備考
STORAGE_OFFLOAD_READ_OUTPUT構造体は、システム バッファーの先頭に返されます。
トークン の値は、ストレージ デバイスのコピー プロバイダーによって生成されます。 IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES 制御コード要求で DEVICE_DSM_INPUT 構造体が送信されたときに含まれるデータ セット範囲は、Tokenによってマークされます。 Token に関連付けられているデータ セット範囲は、DEVICE_DSM_OFFLOAD_READ_PARAMETERS の TimeToLive メンバーの期間が有効である間、後続の書き込み要求で使用できます。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 8 以降のバージョンの Windows で使用できます。 |
ヘッダー | ntddstor.h (Ntddstor.h を含む) |