IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)
Questa IOCTL_EHSTOR_BANDMGMT_ACTIVATE richiesta viene inviata per attivare le funzionalità di sicurezza e la gestione della banda in un dispositivo di archiviazione. La richiesta include le opzioni di attivazione e la chiave di autenticazione.
Codice principale
Buffer di input
Il buffer di input in Irp-AssociatedIrp.SystemBuffer> contiene una struttura ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS viene dichiarato in ehstorbandmgmt.h come indicato di seguito.
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
Di seguito ACTIVATE_REVERT_PARAMETERS nel buffer di sistema è una struttura AUTH_KEY . Contiene i byte di dati chiave per la chiave di autenticazione. AUTH_KEY viene dichiarato in ehstorbandmgmt.h come indicato di seguito.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
Lunghezza del buffer di input
Lunghezza di una struttura ACTIVATE_REVERT_PARAMETERS .
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Blocco dello stato
È possibile restituire uno dei valori seguenti nel campo Stato .
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | Le funzionalità di sicurezza nel dispositivo di archiviazione sono state attivate. |
| STATUS_INVALID_DEVICE_REQUEST | Il dispositivo di archiviazione non supporta la gestione della banda. |
| STATUS_INVALID_BUFFER_SIZE | La dimensione del buffer di input non è valida. |
| STATUS_INVALID_PARAMETER | Le informazioni nel buffer di input non sono valide. |
| STATUS_ACCESS_DENIED | La chiave di autenticazione non è valida. L'attivazione viene negata. |
| STATUS_DEVICE_CONFIGURATION_ERROR | Il sistema non può configurare il dispositivo in modalità supportata. |
| STATUS_IO_DEVICE_ERROR | Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza. |
| STATUS_INVALID_DEVICE_STATE | Il dispositivo di archiviazione è già attivato. |
| STATUS_NOT_SUPPORTED | Le funzionalità di sicurezza nel dispositivo non sono state attivate a causa di un'impostazione di Criteri di gruppo. |
Commenti
Se STATUS_SUCCESS viene restituito da questa richiesta, un driver o un'applicazione può inviare una richiesta di IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES per recuperare le funzionalità di gestione banda abilitate del dispositivo.
Prima di restituire correttamente da IOCTL_EHSTOR_BANDMGMT_ACTIVATE, il dispositivo non viene attivato. Finché il dispositivo non viene attivato, l'unico IOCTL di gestione banda che restituirà correttamente è IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. Dopo l'attivazione, sono disponibili gli IOCTL di gestione banda rimanenti.
L'attivazione dei dispositivi di archiviazione avanzata è controllata dalle impostazioni Criteri di gruppo del sistema. Il valore del Registro di sistema in HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled determina se l'attivazione della sicurezza è abilitata. Un valore REG_DWORD pari a 0 consente l'attivazione della sicurezza nel dispositivo di archiviazione. In caso contrario, il valore 1 disabilita l'attivazione della sicurezza e la richiesta di IOCTL_EHSTOR_BANDMGMT_ACTIVATE restituirà con STATUS_NOT_SUPPORTED.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8. |
| Intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |