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

IRP_MJ_DEVICE_CONTROL

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)

Consulte también

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_REVERT