IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)

存儲設備上已設定的頻帶會隨著 IOCTL_EHSTOR_BANDMGMT_DELETE_BAND 要求一起刪除。 輸入參數中的清除選項可讓要求執行頻帶數據的密碼編譯清除。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

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_PARAMETERSFlags 成員中設定。

刪除帶之後,已刪除的頻帶中包含的所有 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)

另請參閱

DELETE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND