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

Статья
02/06/2025

Структура SET_BAND_LOCATION_PARAMETERS задает параметры для задания свойств расположения для полосы хранения на устройстве хранения для запроса IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION.

Синтаксис

typedef struct _SET_BAND_LOCATION_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
  ULONG         BandLocationInfoOffset;
} SET_BAND_LOCATION_PARAMETERS, *PSET_BAND_LOCATION_PARAMETERS;

Члены

StructSize

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

BandId

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

BandStart

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

AuthKeyOffset

Смещение в байтах структуры AUTH_KEY, содержащей ключ авторизации для полосы. Смещение от начала SET_BAND_LOCATION_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.

BandLocationInfoOffset

Смещение в байтах структуры BAND_LOCATION_INFO. Смещение от начала SET_BAND_LOCATION_PARAMETERS.

Замечания

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

Если BandID и BandStart имеют значение –1, то запрос IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION изменит свойства глобальной группы.

Требования

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

См. также

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION

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