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

Статья
02/06/2025

Структура 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	Включите сведения о алгоритме шифрования мультимедиа в SecurityInfo члена BAND_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<MaxBandCount член BAND_MANAGEMENT_CAPABILITIES, если BandID больше 0, а BandID меньше MaxBandCount члена BAND_MANAGEMENT_CAPABILITIES, BandID используется в качестве единственного критерия выбора для совпадения группы. Если BandID == –1, BandStart и BandSize используются в качестве критериев соответствия для выбора группы.

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

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

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

Требования

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

См. также

BAND_MANAGEMENT_CAPABILITIES

BAND_TABLE

BAND_TABLE_ENTRY

IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS

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