共用方式為

BAND_MANAGEMENT_CAPABILITIES結構 （ehstorbandmgmt.h）

  • 發行項

BAND_MANAGEMENT_CAPABILITIES 結構包含記憶體裝置可用的安全性功能。 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES 要求會在系統緩衝區中傳回這個結構。

語法

typedef struct _BAND_MANAGEMENT_CAPABILITIES {
  ULONG     StructSize;
  ULONG     Capabilities;
  ULONGLONG KeyProtectionMechanism;
  ULONG     MinAuthKeyLength;
  ULONG     MaxAuthKeyLength;
  ULONG     MaxBandCount;
  ULONG     MaxSimultaneousReencryptionCount;
  ULONG     BandMetadataSize;
} BAND_MANAGEMENT_CAPABILITIES, *PBAND_MANAGEMENT_CAPABILITIES;

成員

StructSize

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

Capabilities

存儲設備的安全性功能旗標。 這是下列旗標的位 OR 值。

價值 意義
CAPS_ACTIVATED
 如果已設定，則此結構的功能成員可供使用。 否則，這個結構的其餘成員無效。
CAPS_BANDCROSSING_SUPPORTED
 存儲設備支援跨多個頻段的讀取和寫入。 如果未設定此旗標，則跨越多個頻段的單一讀取或寫入會分割成裝置的多個 IO 要求。
CAPS_SID_SECURED
 SID 授權單位受到保護。 如果設定，預設 SID 針腳無法用來修改儲存裝置的安全性組態。

KeyProtectionMechanism

用來保護媒體金鑰的機制。 此成員會設定為下列其中一項。

價值 意義
0
 金鑰不受保護。
MEDIAKEY_PROTECTEDBY_VENDORSCHEME
 金鑰受到廠商提供的方法保護。 請勿使用。 不支援此選項。
MEDIAKEY_PROTECTEDBY_AUTHKEY
 金鑰是由衍生自頻帶驗證金鑰的金鑰加密。 密鑰衍生會導致從頻帶驗證數據中遺失微不足道的 entropy。

MinAuthKeyLength

帶寬驗證的最小長度，以位元組為單位，或清除存儲設備所接受的密鑰。

MaxAuthKeyLength

帶寬驗證的最大長度，以位元組為單位，或清除存儲設備所接受的密鑰。

MaxBandCount

儲存裝置中設定的最大同時頻帶數目。 這包括全域頻帶。

MaxSimultaneousReencryptionCount

裝置上硬體支持的同時頻外重新加密數目。 如果此成員為 0，則不支援硬體驅動頻帶重新加密。

BandMetadataSize

每個頻帶元數據存放區的大小，以位元組為單位。

言論

如果未在 功能中設定 CAPS_ACTIVATED，則可以使用 IOCTL_EHSTOR_BANDMGMT_ACTIVATE 要求來啟用安全性功能。

要求

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

另請參閱

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES