IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)

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.

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

Vedi anche

IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES

SILO_DRIVER_CAPABILITES