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 (包括 EhStorBandMgmt.h)

另請參閱

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES