IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)

IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ отправляется расширенным драйвером класса хранилища (EHSTOR) в драйвер silo для инициирования проверки подлинности по запросу или отмены проверки подлинности.

Основной код

IRP_MJ_DEVICE_CONTROL

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

Входной буфер в Irp-AssociatedIrp.SystemBuffer> должен содержать AUTHZ_STATE структуру, указывающую тип выполняемой операции проверки подлинности. AUTHZ_STATE объявляется в ehstorioctl.h следующим образом.

typedef struct _AUTHZ_STATE
{
    ULONG AuthzState;
} AUTHZ_STATE;

Значение AuthzState указывает операцию проверки подлинности. Это один из следующих вариантов.

Значение	Описание
0	Отмена проверки подлинности по запросу.
AUTHZSTATE_AUTHENTICATE	Выполнять проверку подлинности по запросу.
AUTHZSTATE_CLEAR_AUTHKEY_CACHE	Отмените проверку подлинности по запросу и очистите кэшированные ключи проверки подлинности.

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

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

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

Нет.

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

Нет.

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

STATUS_SUCCESS возвращается в поле Состояние драйвером silo при изменении состояния проверки подлинности. В противном случае возвращается STATUS_UNSUCCESSFUL.

Комментарии

Этот IOCTL отправляется EHSTOR в драйвер silo, который поддерживает проверку подлинности по запросу. Драйвер silo уведомляет EHSTOR об этой возможности в предыдущем запросе IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES с флагом CAP_ON_DEMAND_AUTHENTICATION , установленным в элементе CapabilitiesSILO_DRIVER_CAPABILITES.

В ответ на этот IOCTL драйвер silo выполняет проверку подлинности или отмену проверки подлинности для устройства. Для устройств с чередованием драйвер silo в зависимости от указанной операции в системном буфере разблокирует или заблокирует как можно больше диапазонов для операций чтения и записи.

Если драйверу silo не удается выполнить запрошенную операцию, состояние проверки подлинности устройства не изменится.

Если член AuthzStateAUTHZ_STATE имеет значение AUTHZSTATE_CLEAR_AUTHKEY_CACHE, драйвер silo очищает кэш ключей проверки подлинности в дополнение к отмене проверки подлинности. AUTHZSTATE_CLEAR_AUTHKEY_CACHE устанавливается при завершении работы системы или режиме гибернации. Это предотвращает наличие кэша ключей в файле гибернации.

Если устройство поддерживает несколько изолированных устройств, проверка подлинности каждого из них является монопольной. Операция проверки подлинности одним драйвером silo не влияет на состояние проверки подлинности, заданное другим драйвером silo.

Требования

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

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

IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES

SILO_DRIVER_CAPABILITES