IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)
存儲設備上已設定的頻帶會隨著 IOCTL_EHSTOR_BANDMGMT_DELETE_BAND 要求一起刪除。 輸入參數中的清除選項可讓要求執行頻帶數據的密碼編譯清除。
Irp->AssociatedIrp.SystemBuffer 的輸入緩衝區必須包含 DELETE_BAND_PARAMETERS,而且可能是 AUTH_KEY 結構。
如果 AuthKeyOffset 成員的 DELETE_BAND_PARAMETERS 設定為 EHSTOR_BANDMGR_NO_KEY,則系統緩衝區中的輸入數據不需要包含 AUTH_KEY 結構。
Parameters.DeviceIoControl.InputBufferLength 指出緩衝區的大小,其大小至少必須是 sizeof (DELETE_BAND_PARAMETERS) + sizeof(AUTH_KEY)。
沒有。
沒有。
下列其中一個值可以在 [狀態] 字段中傳回。
狀態值 | 描述 |
---|---|
STATUS_SUCCESS | 已成功刪除樂隊。 |
STATUS_INVALID_DEVICE_REQUEST | 存儲設備不支援頻帶管理。 |
STATUS_INVALID_BUFFER_SIZE | 輸入緩衝區大小不正確。 |
STATUS_INVALID_PARAMETER | 輸入緩衝區中的資訊無效。 |
STATUS_ACCESS_DENIED | 驗證金鑰無效,或頻帶已鎖定以供寫入。 |
STATUS_NOT_FOUND | 在提供的選取準則中找不到帶狀。 |
STATUS_IO_DEVICE_ERROR | 通訊失敗。 存儲設備可能與安全性通訊協定不相容。 |
需要驗證金鑰才能刪除頻帶,而不需要先執行清除。 若要要求帶清除,DELBAND_ERASE_BEFORE_DELETE 旗標會在 DELETE_BAND_PARAMETERS的 Flags 成員中設定。
刪除帶之後,已刪除的頻帶中包含的所有 LBA 都會傳回至全域頻帶。 全域頻帶的鎖定條件現在適用於傳回至全域波段的 LBA。 傳回至全域波段的 LBA 現在與全域頻帶的媒體密鑰相關聯,而且無法復原這些 LBA 中的加密數據。
已刪除的頻帶會保留在尋址接收器驅動程式的頻帶數據表中,但變成未設定。 驗證金鑰會重設為預設值、帶狀和金鑰元數據包含零,而鎖定狀態會還原為 PERSISTENT_UNLOCK。 頻帶現在可供使用 IOCTL_EHSTOR_BANDMGMT_CREATE_BAND 要求重新設定。
刪除沒有密碼編譯清除的頻帶將不會移除該波段的加密密鑰。 稍後可以建立與已刪除的頻帶相同的組態和頻帶標識碼的頻帶。 在此情況下,先前儲存在頻帶中的數據,且不會覆寫,因為前一個頻帶的刪除將可供使用。 若要避免這種情況,請刪除具有 DELETE_BAND_PARAMETERS中所設定 DELBAND_ERASE_BEFORE_DELETE 旗標的帶狀。
IOCTL_EHSTOR_BANDMGMT_DELETE_BAND 不會刪除全域頻帶。 若要這樣做的要求,將會傳回 STATUS_INVALID_PARAMETER。
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始提供。 |
標頭 | ehstorbandmgmt.h (include EhStorBandMgmt.h) |