IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)

Запрос IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES извлекает возможности безопасности в диапазоне для запоминаемого устройства. IOCTL возвращает возможности в виде структуры BAND_MANAGEMENT_CAPABILITIES в системном буфере.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Нет.

Длина входного буфера

Нет.

Выходной буфер

Выходной буфер в 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)

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

BAND_MANAGEMENT_CAPABILITIES