IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)
Запрос IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES извлекает возможности безопасности в диапазоне для запоминаемого устройства. IOCTL возвращает возможности в виде структуры BAND_MANAGEMENT_CAPABILITIES в системном буфере.
Основной код
Входной буфер
Нет.
Длина входного буфера
Нет.
Выходной буфер
Выходной буфер в Irp-AssociatedIrp.SystemBuffer> содержит BAND_MANAGEMENT_CAPABILITIES структуру.
Длина выходного буфера
Длина структуры BAND_MANAGEMENT_CAPABILITIES .
Блок состояния
Поле Information содержит количество байтов, возвращаемых в выходном буфере. В поле Состояние можно вернуть одно из следующих значений.
| Значение состояния | Описание |
|---|---|
| STATUS_SUCCESS | Устройство поддерживает управление диапазоном, и возможности безопасности возвращаются в системном буфере. |
| STATUS_INVALID_DEVICE_REQUEST | Управление диапазоном не поддерживается на запоминаемом устройстве. |
| STATUS_INVALID_DEVICE_STATE | Устройство обеспечивает поддержку управления диапазоном, но не в текущей конфигурации. |
| STATUS_BUFFER_OVERFLOW | Буфер не указан или его размер равен нулю. Требуемый размер возвращается в поле Сведения . |
| STATUS_BUFFER_TOO_SMALL | Размер буфера слишком мал для возврата выходных данных. |
Комментарии
Драйвер или приложение может запросить необходимый размер выходного буфера, задав для этого запроса значение NULL, а размер выходных данных — 0. Запрос IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES возвращается с полем Состояние блока IoStatus , равным STATUS_BUFFER_OVERFLOW а поле Сведения будет содержать требуемый размер буфера.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно, начиная с Windows 8 |
| Верхняя часть | ehstorbandmgmt.h (включая EhStorBandMgmt.h) |