IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)
Esta IOCTL_EHSTOR_BANDMGMT_ACTIVATE solicitud se envía para activar las características de seguridad y la administración de bandas en un dispositivo de almacenamiento. La solicitud incluye opciones de activación y la clave de autenticación.
Código principal
Búfer de entrada
El búfer de entrada en Irp-AssociatedIrp.SystemBuffer> contiene una estructura de ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS se declara en ehstorbandmgmt.h como se indica a continuación.
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
El siguiente ACTIVATE_REVERT_PARAMETERS en el búfer del sistema es una estructura AUTH_KEY . Contiene los bytes de datos clave para la clave de autenticación. AUTH_KEY se declara en ehstorbandmgmt.h como se indica a continuación.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
Longitud del búfer de entrada
Longitud de una estructura de ACTIVATE_REVERT_PARAMETERS .
Búfer de salida
Ninguno.
Longitud del búfer de salida
Ninguno.
Bloque de estado
Se puede devolver uno de los valores siguientes en el campo Estado .
Valor de estado | Descripción |
---|---|
STATUS_SUCCESS | Se activaron las características de seguridad en el dispositivo de almacenamiento. |
STATUS_INVALID_DEVICE_REQUEST | El dispositivo de almacenamiento no admite la administración de bandas. |
STATUS_INVALID_BUFFER_SIZE | El tamaño del búfer de entrada no es válido. |
STATUS_INVALID_PARAMETER | La información del búfer de entrada no es válida. |
STATUS_ACCESS_DENIED | La clave de autenticación no es válida. Se deniega la activación. |
STATUS_DEVICE_CONFIGURATION_ERROR | El sistema no puede configurar el dispositivo en un modo compatible. |
STATUS_IO_DEVICE_ERROR | Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad. |
STATUS_INVALID_DEVICE_STATE | El dispositivo de almacenamiento ya está activado. |
STATUS_NOT_SUPPORTED | Las características de seguridad del dispositivo no se activaron debido a una configuración de directiva de grupo. |
Comentarios
Si se devuelve STATUS_SUCCESS de esta solicitud, un controlador o una aplicación pueden enviar una solicitud de IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES para recuperar las funcionalidades de administración de banda habilitadas del dispositivo.
Antes de una devolución correcta de IOCTL_EHSTOR_BANDMGMT_ACTIVATE, el dispositivo no se activa. Hasta que se active el dispositivo, el único IOCTL de administración de banda que se devolverá correctamente es IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. Después de la activación, están disponibles las ICTL de administración de banda restantes.
La activación de dispositivos de almacenamiento mejorado se controla mediante la configuración de directiva de grupo del sistema. El valor del Registro en HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled determina si la activación de seguridad está habilitada. Un valor de REG_DWORD de 0 permite la activación de seguridad en el dispositivo de almacenamiento. De lo contrario, un valor de 1 deshabilita la activación de seguridad y la solicitud de IOCTL_EHSTOR_BANDMGMT_ACTIVATE devolverá con STATUS_NOT_SUPPORTED.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible a partir de Windows 8. |
Encabezado | ehstorbandmgmt.h (incluya EhStorBandMgmt.h) |