BAND_MANAGEMENT_CAPABILITIES structure (ehstorbandmgmt.h)
The BAND_MANAGEMENT_CAPABILITIES structure contains the security capabilities available for a storage device. This structure is returned in the system buffer by the IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES request.
Syntax
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;
Members
StructSize
The size of this structure in bytes. Set to sizeof(BAND_MANAGEMENT_CAPABILITIES).
Capabilities
Security capability flags for a storage device. This is a bitwise OR value of the following flags.
KeyProtectionMechanism
The mechanism used to protect the media keys. This member is set to one of the following.
MinAuthKeyLength
The minimum length, in bytes, of the band authentication or erase keys accepted by the storage device.
MaxAuthKeyLength
The maximum length, in bytes, of the band authentication or erase keys accepted by the storage device.
MaxBandCount
The maximum number of simultaneous bands configured in the storage device. This includes the global band.
MaxSimultaneousReencryptionCount
The number of simultaneous band re-encryptions the hardware on the device supports. If this member is 0, hardware-driven band re-encryptions are not supported.
BandMetadataSize
The size, in bytes, of the per band metadata store.
Remarks
If CAPS_ACTIVATED is not set in Capabilities, security functionality can be activated with the IOCTL_EHSTOR_BANDMGMT_ACTIVATE request.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Available starting with Windows 8 |
Header | ehstorbandmgmt.h (include EhStorBandMgmt.h) |