CREATE_BAND_PARAMETERS 结构 (ehstorbandmgmt.h)

  • 项目

在存储设备上为 IOCTL_EHSTOR_BANDMGMT_CREATE_BAND 请求创建带的参数在 CREATE_BAND_PARAMETERS 结构中指定。

语法

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

成员

StructSize

此结构的大小（以字节为单位）。 将 设置为 sizeof (CREATE_BAND_PARAMETERS) 。

Flags

带创建标志。 此值是以下内容的按位 OR 组合。

值 含义
CREATEBAND_AUTHKEY_CACHING_ENABLED
 缓存此波段的身份验证密钥，从而允许后续操作的自动化。 设置此标志且未锁定用于读取和写入的波段时，将缓存身份验证密钥。

BandLocationInfoOffset

BAND_LOCATION_INFO结构的偏移量（以字节为单位）。 偏移量从 CREATE_BAND_PARAMETERS的开头开始。

BandSecurityInfoOffset

BAND_SECURITY_INFO结构的偏移量（以字节为单位）。 偏移量从 CREATE_BAND_PARAMETERS的开头开始。 如果此值为 0，则表示不存在带安全信息，则波段的密钥管理器元数据将设置为所有零。 此外，当此成员为 0 时，读取和写入锁定状态默认为PERSISTANT_UNLOCK。

AuthKeyOffset

包含新带的授权密钥的 AUTH_KEY 结构的偏移量（以字节为单位）。 偏移量从 CREATE_BAND_PARAMETERS的开头开始。 AUTH_KEY 在 ehstorbandmgmt.h 中声明如下。

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

KeySize

密钥的键数据的大小（以字节为单位）。 如果 KeySize 设置为 0，则使用默认键。

密钥

包含键数据的可变长度字节数组。

若要将默认授权密钥分配给带，请设置 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY。

注解

BandSecurityInfoOffsetBAND_SECURITY_INFO 结构的 CryptoAlgoIdType 和 CryptoAlgoOidString 成员不在带创建请求中使用，必须设置为 0。

要求

要求 值
最低受支持的客户端 从Windows 8开始可用
标头 ehstorbandmgmt.h (包括 EhStorBandMgmt.h)

另请参阅

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND