Share via

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

  • Статья

Структура ENUMERATE_BANDS_PARAMETERS используется для выбора записей сведений о полосе, выбранных для возврата из запроса IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS .

Синтаксис

typedef struct _ENUMERATE_BANDS_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  LARGE_INTEGER BandSize;
} ENUMERATE_BANDS_PARAMETERS, *PENUMERATE_BANDS_PARAMETERS;

Члены

StructSize

Размер этой структуры в байтах. Задайте для параметра sizeof(ENUMERATE_BANDS_PARAMETERS).

Flags

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

Значение Значение
ENUMBANDS_ENUM_ALL_BANDS
 Возвращаются все полосы. Если этот флаг установлен, элементы BandId, BandStart и BandSize игнорируются.
ENUMBANDS_REPORT_CRYPTO_ALGO
 Включите сведения об алгоритме шифрования мультимедиа в элемент SecurityInfoBAND_TABLE_ENTRY.

Reserved

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

BandId

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

BandStart

Начальное расположение байтов на запоминающее устройство для начала поиска по полосе. Выполняется попытка сопоставить группу в bandStart или после нее.

BandSize

Необязательное значение соответствия размера полосы в байтах. Если BandSize == 0 и BandId == –1, то BandStart является единственным значением соответствия для выбора диапазона. В противном случае выбирается диапазон в или после BandStart и точно соответствующий BandSize .

Комментарии

Если ENUMBANDS_ENUM_ALL_BANDS не задано в разделе Флаги, выполняется попытка выбора в соответствии с одной полосой. Совпадение с одной полосой выполняется на основе значений в BandID, BandStart и BandSize. Приоритет присваивается BandID для выбора полосы. Если элемент BandID> 0 и BandID<MaxBandCountBAND_MANAGEMENT_CAPABILITIES Если BandID больше 0, а BandID меньше, чем член MaxBandCountBAND_MANAGEMENT_CAPABILITIES, то BandID используется в качестве единственного критерия выбора для совпадения группы. Если BandID == –1, в качестве критериев соответствия для выбора группы используются BandStart и BandSize .

Если bandStart и BandSize используются для сопоставления с диапазоном, возвращается первый диапазон, настроенный в расположении BandStart или после него с точным размером BandSize . Если BandSize == 0, то при действии BandStart возвращается первая полоса, настроенная в или после BandStart .

Если BandID == 0 или не настроены полосы и для параметра Flags не задано значение ENUMBANDS_ENUM_ALL_BANDS, возвращается глобальный диапазон для всего устройства.

BandStart и BandSize недопустимы, если их значения в байтах точно не кратны размеру сектора базового запоминающего устройства.

Требования

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

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

BAND_MANAGEMENT_CAPABILITIES

BAND_TABLE

BAND_TABLE_ENTRY

IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS