Share via

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

  • Статья

Метаданные для настроенного диапазона извлекаются в соответствии с параметрами в структуре GET_BAND_METADATA_PARAMETERS . Эта структура является входной для запроса IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA .

Синтаксис

typedef struct _GET_BAND_METADATA_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         MetadataOffset;
  ULONG         MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;

Члены

StructSize

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

BandId

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

BandStart

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

MetadataOffset

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

MetadataSize

Длина извлекаемых байтов метаданных.

Комментарии

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

Если для bandID и BandStart задано значение –1, то IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA возвращает метаданные для глобального диапазона.

Если IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA выполнено успешно, значение Parameters.DeviceIoControl.InputBufferLength равно значению в MetadataSize.

Требования

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

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

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA