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

Статья
02/06/2025

Метаданные для настроенной полосы извлекаются в соответствии с параметрами в структуре 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

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

BandId

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

BandStart

Начальное расположение байтов на устройстве хранилища, чтобы начать поиск по группе. Попытка сопоставить группу или после BandStart.

MetadataOffset

Смещение от начала свойства метаданных полосы для получения данных.

MetadataSize

Длина байтов метаданных для получения.

Замечания

Приоритет присваивается BandID для выбора диапазона. Если BandID больше 0, а BandID меньше, чем maxBandCount члена BAND_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 равно значению в МетаданныеSize.

Требования

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

См. также

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA

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