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

Статья
02/26/2024

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

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

Ключ

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

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

BandLocationInfoOffset

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

Приоритет присваивается BandID для выбора полосы. Если bandID больше 0, а BandID меньше, чем элемент MaxBandCountBAND_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 (включая EhStorBandMgmt.h)

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

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION

Share via