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


IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)

Этот IOCTL_EHSTOR_BANDMGMT_ACTIVATE запрос отправляется для активации функций безопасности и управления диапазоном на запоминающее устройство. Запрос включает параметры активации и ключ проверки подлинности.

Основной код

IRP_MJ_DEVICE_CONTROL

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

Входной буфер в Irp-AssociatedIrp.SystemBuffer> содержит структуру ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS объявляется в ehstorbandmgmt.h следующим образом.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

Следующие ACTIVATE_REVERT_PARAMETERS в системном буфере являются AUTH_KEY структурой. Он содержит байты данных ключа для ключа проверки подлинности. AUTH_KEY объявляется в ehstorbandmgmt.h следующим образом.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

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

Длина структуры ACTIVATE_REVERT_PARAMETERS .

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

Нет.

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

Нет.

Блок состояния

Одно из следующих значений можно вернуть в поле Состояние .

Значение состояния Описание
STATUS_SUCCESS Были активированы функции безопасности на запоминающее устройство.
STATUS_INVALID_DEVICE_REQUEST Устройство хранения не поддерживает управление диапазоном.
STATUS_INVALID_BUFFER_SIZE Недопустимый размер входного буфера.
STATUS_INVALID_PARAMETER Недопустимые сведения во входном буфере.
STATUS_ACCESS_DENIED Недопустимый ключ проверки подлинности. Отказано в активации.
STATUS_DEVICE_CONFIGURATION_ERROR Система не может настроить устройство в поддерживаемом режиме.
STATUS_IO_DEVICE_ERROR Сбой связи. Устройство хранения может быть несовместимо с протоколами безопасности.
STATUS_INVALID_DEVICE_STATE Устройство хранения уже активировано.
STATUS_NOT_SUPPORTED Функции безопасности на устройстве не были активированы из-за параметра групповая политика.

Комментарии

Если из этого запроса возвращается STATUS_SUCCESS, драйвер или приложение может отправить запрос IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES для получения включенных возможностей управления полосой устройства.

До успешного возврата из IOCTL_EHSTOR_BANDMGMT_ACTIVATE устройство не активируется. Пока устройство не будет активировано, единственным возвратом IOCTL полосы управления будет IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. После активации доступны оставшиеся ioCTL управления диапазоном.

Активация устройств расширенного хранилища управляется групповая политика параметрами системы. Значение реестра HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled определяет, включена ли активация безопасности. Значение REG_DWORD 0 позволяет активировать безопасность на запоминающее устройство. В противном случае значение 1 отключает активацию системы безопасности, и запрос IOCTL_EHSTOR_BANDMGMT_ACTIVATEвозвращается с STATUS_NOT_SUPPORTED.

Требования

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

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

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_REVERT