структура 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
Флаги перечисления диапазона. Это значение представляет собой побитовую или комбинацию следующего.
| Значение | Значение |
|---|---|
|
Возвращаются все полосы. Если этот флаг установлен, элементы BandId, BandStart и BandSize игнорируются. |
|
Включите сведения об алгоритме шифрования мультимедиа в элемент 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) |