ERASE_BAND_PARAMETERS 结构 (ehstorbandmgmt.h)

项目
02/26/2024

ERASE_BAND_PARAMETERS结构包含要擦除的波段的选择条件。此外，还可以设置新的身份验证密钥。此结构是 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 请求的输入。

语法

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 或 BandStart 之后匹配一个乐队。

NewAuthKeyOffset

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

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

KeySize

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

密钥

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

若要指定带的默认身份验证密钥，请设置 NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY。

注解

优先于 BandID 进行波段选择。如果 BandID 大于 0 且 BandID 小于 BAND_MANAGEMENT_CAPABILITIES 的 MaxBandCount 成员，则 BandID 用作带匹配的唯一选择条件。如果 BandID == –1，则将 BandStart 用作选择波段的匹配条件。如果没有波段与任一选择条件匹配，则会在 IoStatus 块中返回 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND STATUS_INVALID_PARAMETER。