Condividi tramite

IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)

  • Articolo

IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ viene inviato dal driver EHSTOR (Enhanced Storage Class Driver) al driver silo per avviare l'autenticazione o la deautenticazione su richiesta.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer di input in Irp-AssociatedIrp.SystemBuffer> deve contenere una struttura AUTHZ_STATE che indica il tipo di operazione di autenticazione da eseguire. AUTHZ_STATE viene dichiarato in ehstorioctl.h come indicato di seguito.

typedef struct _AUTHZ_STATE
{
    ULONG AuthzState;
} AUTHZ_STATE;

Il valore di AuthzState specifica l'operazione di autenticazione. Questo è uno dei seguenti.

Valore Descrizione
0 Eseguire la deautenticazione su richiesta.
AUTHZSTATE_AUTHENTICATE Eseguire l'autenticazione su richiesta.
AUTHZSTATE_CLEAR_AUTHKEY_CACHE Eseguire la deautenticazione su richiesta e cancellare le chiavi di autenticazione memorizzate nella cache.

Lunghezza del buffer di input

Lunghezza di una struttura AUTHZ_STATE .

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Blocco dello stato

STATUS_SUCCESS viene restituito nel campo Stato dal driver silo se lo stato di autenticazione viene modificato. In caso contrario, viene restituito STATUS_UNSUCCESSFUL.

Commenti

Questo IOCTL viene inviato da EHSTOR a un driver silo che supporta l'autenticazione su richiesta. Il driver silo notifica a EHSTOR questa funzionalità in una richiesta IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES precedente con il flag CAP_ON_DEMAND_AUTHENTICATION impostato nel membro Capabilities di SILO_DRIVER_CAPABILITES.

In risposta a questo IOCTL, il driver silo esegue l'autenticazione o la deautenticazione per il dispositivo. Per i dispositivi con banda, il driver silo eseguirà, a seconda dell'operazione specificata nel buffer di sistema, sbloccare o bloccare il maggior numero possibile di bande per letture e scritture.

Se il driver silo non riesce a eseguire l'operazione richiesta, non modificherà lo stato di autenticazione di un dispositivo.

Se il membro AuthzState di AUTHZ_STATE è impostato su AUTHZSTATE_CLEAR_AUTHKEY_CACHE, il driver silo cancella la cache delle chiavi di autenticazione oltre alla deautenticazione. AUTHZSTATE_CLEAR_AUTHKEY_CACHE viene impostato quando il sistema si arresta o l'ibernazione. Ciò impedisce la presenza della cache delle chiavi nel file di ibernazione.

Se un dispositivo supporta più silo, l'autenticazione per ogni silo è esclusiva. Un'operazione di autenticazione da un driver silo non influisce sullo stato di autenticazione impostato da un altro driver silo.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8
Intestazione ehstorioctl.h (include EhStorIoctl.h)

Vedi anche

IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES

SILO_DRIVER_CAPABILITES