IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

El IOCTL_EHSTOR_BANDMGMT_ERASE_BAND solicita la eliminación criptográfica y restablece la clave de autenticación de una banda. La configuración restante de la banda se deja sin modificar.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El búfer de entrada en Irp-AssociatedIrp.SystemBuffer> debe contener una ERASE_BAND_PARAMETERS y posiblemente una estructura de AUTH_KEY.

Si el miembro NewAuthKeyOffset de ERASE_BAND_PARAMETERS se establece en EHSTOR_BANDMGR_NO_KEY, los datos de entrada del búfer del sistema no necesitan incluir una estructura de AUTH_KEY .

Longitud del búfer de entrada

Parameters.DeviceIoControl.InputBufferLength indica el tamaño, en bytes, del búfer, que debe ser al menos sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

Búfer de salida

Ninguno.

Longitud del búfer de salida

Ninguno.

Búfer de entrada y salida

Ninguno.

Longitud del búfer de entrada y salida

Ninguno.

Bloque de estado

Se puede devolver uno de los valores siguientes en el campo Estado .

Valor de estado	Descripción
STATUS_SUCCESS	La banda fue borrada correctamente.
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 es incorrecto.
STATUS_INVALID_PARAMETER	La información del búfer de entrada no es válida.
STATUS_ACCESS_DENIED	La clave de autenticación de borrado no es una clave predeterminada y la banda no se puede borrar.
STATUS_NOT_FOUND	No se encontró la banda para los criterios de selección proporcionados.
STATUS_IO_DEVICE_ERROR	Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad.

Comentarios

No se proporciona una clave de autenticación de borrado actual en una solicitud de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND . La clave de autenticación de borrado del dispositivo de almacenamiento se ha configurado previamente.

No se proporciona ningún método en Windows para cambiar la clave de autenticación de borrado de un dispositivo de almacenamiento. Siempre que los parámetros correctos se proporcionen como entrada en el búfer del sistema, esta solicitud debe realizarse correctamente. Si la clave de autenticación de borrado se cambió fuera de Windows, como en un entorno de arranque dual con un sistema operativo diferente, esta solicitud puede producir un error.

Cuando se borra una banda con IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, las únicas propiedades anteriores que permanecen son el inicio de banda y el tamaño de banda. Se quita la clave de cifrado multimedia anterior y se genera una nueva clave. El bloqueo se establece en PERSISTANT_UNLOCK tanto para lectura como para escritura. Los metadatos de seguridad establecidos anteriormente se borran. La nueva clave de autenticación especificada en ERASE_BAND_PARAMETERS se establece a menos que se indique el uso de la clave predeterminada.

Para evitar que otras aplicaciones controlen una banda y borren mediante la clave predeterminada, se debe incluir una nueva clave de autenticación con la solicitud IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Los cambios realizados en la tabla de bandas por esta solicitud se confirman en el dispositivo de forma atómica antes de que se complete la solicitud IOCTL. Por lo tanto, se garantiza que la banda se modifique con todas sus propiedades establecidas o que no se establezca ninguna propiedad en absoluto si se produce un error de alimentación o sistema.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Encabezado	ehstorbandmgmt.h (incluya EhStorBandMgmt.h)

Consulte también

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS