STORAGE_OFFLOAD_READ_OUTPUT 結構 (ntddstor.h)
當DEVICE_DSM_INPUT結構的Action成員設定為DeviceDsmAction_OffloadRead時,STORAGE_OFFLOAD_READ_OUTPUT結構是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
複製提供者針對 Token 讀取和保留的數據總長度,以位元組為單位。
TokenLength
Token 的長度,以位元組為單位。
Token
複製提供者所傳回的唯一標識符,標示讀取的數據集範圍。
備註
STORAGE_OFFLOAD_READ_OUTPUT結構會在系統緩衝區的開頭傳回。
Token 的值是由記憶體裝置的複製提供者所產生。 在IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES控件程式代碼要求中傳送DEVICE_DSM_INPUT結構時,包含的數據集範圍會以 Token 標示。 與 Token 相關聯的數據集範圍可用於後續的寫入要求,而 timeToLive 成員 DEVICE_DSM_OFFLOAD_READ_PARAMETERS的 TimeToLive 成員有效時,
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 及更新版本的 Windows 中提供。 |
標頭 | ntddstor.h (包含 Ntddstor.h) |