структура 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

Удалить флаги операций. Это значение является побитовой комбинацией ИЛИ следующего.

Значение	Значение
ERASEBAND_AUTHKEY_CACHING_ENABLED	Новый ключ проверки подлинности для этого диапазона кэшируется, что позволяет автоматизировать последующие операции.

Reserved

Зарезервировано.

BandId

Идентификатор одного диапазона для возврата сведений. BandSize должен иметь значение 0, если выбрана одна полоса с идентификатором BandId. Чтобы использовать BandStart и BandSize вместо BandId для выбора полосы, задайте bandId = (ULONG) –1.

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, используется ключ по умолчанию.

Ключ

Массив байтов переменной длины, содержащий ключевые данные.

Чтобы указать ключ проверки подлинности по умолчанию для полосы, задайтеEHSTOR_BANDMGR_NO_KEYNewAuthKeyOffset = .

Приоритет присваивается BandID для выбора полосы. Если bandID больше 0, а BandID меньше, чем элемент MaxBandCountBAND_MANAGEMENT_CAPABILITIES, то BandID используется в качестве единственного критерия выбора для совпадения диапазона. Если BandID == –1, в качестве критерия соответствия для выбора полосы используется BandStart . Если ни один диапазон не соответствует ни один из критериев выбора, STATUS_INVALID_PARAMETER возвращается в блоке IoStatus для IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.

Требования

Требование	Значение
Минимальная версия клиента	Доступно, начиная с Windows 8
Верхняя часть	ehstorbandmgmt.h (включая EhStorBandMgmt.h)

См. также раздел

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND

Поделиться через