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


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

Настроенная полоса удаляется в соответствии с параметрами в DELETE_BAND_PARAMETERS структуре. Эта структура является входной для запроса IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Синтаксис

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

Члены

StructSize

Размер этой структуры в байтах. Задайте значение sizeof(DELETE_BAND_PARAMETERS).

Flags

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

Ценность Значение
DELBAND_ERASE_BEFORE_DELETE
Перед удалением выполните криптографическую очистку данных свойства группы.

Reserved

Скрытный.

BandId

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

BandStart

Начальное расположение байтов на устройстве хранилища, чтобы начать поиск по группе. Попытка сопоставить группу или после BandStart.

AuthKeyOffset

Смещение в байтах структуры AUTH_KEY, содержащей ключ авторизации для полосы. Смещение начинается с начала DELETE_BAND_PARAMETERS. AUTH_KEY объявлен в ehstorbandmgmt.h следующим образом.

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

KeySize

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

Ключ

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

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

Замечания

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

Если DELBAND_ERASE_BEFORE_DELETE задан в Флаги, для удаления полосы не требуется ключ проверки подлинности. Если этот флаг не задан, текущий ключ проверки подлинности должен быть включен в AuthKeyOffset.

.

Требования

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

См. также

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND