閱讀英文

共用方式為

ERASE_BAND_PARAMETERS結構 （ehstorbandmgmt.h）

  • 發行項

ERASE_BAND_PARAMETERS 結構包含要清除的頻帶選取準則。 此外，也可以設定新的驗證金鑰。 此結構是 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 要求的輸入。

語法

C++ 
typedef struct _ERASE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;

成員

StructSize

這個結構的大小，以位元組為單位。 設定為 sizeof（ERASE_BAND_PARAMETERS）。

Flags

刪除作業旗標。 此值是下列的位 OR 組合。

價值 意義
ERASEBAND_AUTHKEY_CACHING_ENABLED
 此頻帶的新驗證金鑰會快取，以允許稍後的作業自動化。

Reserved

保留。

BandId

要傳回資訊之單一頻帶的標識碼。 當選取具有 BandId 的單一波段時，BandSize 必須是 0。 若要使用 BandStart 和 BandSize，而不要使用 BandId 來選取樂隊，請將 BandId = （ULONG） –1。

BandStart

存儲設備上的起始位元組位置，以開始進行頻帶搜尋。 嘗試 BandStart之後比對樂隊。

NewAuthKeyOffset

包含頻帶新授權金鑰之 AUTH_KEY 結構的位移，以位元組為單位。 位移是從 ERASE_BAND_PARAMETERS開頭。 AUTH_KEY 會在 ehstorbandmgmt.h 中宣告如下。

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

索引鍵資料的大小，以位元組為單位，Key。 如果 KeySize 設為 0，則會使用預設密鑰。

鑰匙

包含索引鍵數據的可變長度位元組陣列。

若要將預設驗證金鑰指定至頻外，請設定 NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY。

言論

優先於 BandID 進行頻帶選取。 如果 BandID 大於 0，且 BandID 小於 BAND_MANAGEMENT_CAPABILITIESMaxBandCount 成員，則 BandID 會作為樂隊相符的唯一選取準則。 如果 BandID == –1，則會使用 BandStart 作為選取帶的比對準則。 如果沒有符合任一選取準則的頻帶，則會在 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND的 IoStatus 區塊中傳回STATUS_INVALID_PARAMETER。

.

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供
標頭 ehstorbandmgmt.h （include EhStorBandMgmt.h）

另請參閱

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND