структура ERASE_BAND_PARAMETERS (ehstorbandmgmt.h)

Статья
02/06/2025

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

Размер ключа в байтах ключевых данных в Key. Если для KeySize задано значение 0, используется ключ по умолчанию.

Ключ

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

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8
заголовка	ehstorbandmgmt.h (include EhStorBandMgmt.h)

См. также

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND

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