структура 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) |