IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)

Se elimina una banda configurada en un dispositivo de almacenamiento con la solicitud IOCTL_EHSTOR_BANDMGMT_DELETE_BAND . Una opción de borrado en los parámetros de entrada permite que la solicitud realice una borrado criptográfico de los datos de banda.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

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

Si el miembro AuthKeyOffset de DELETE_BAND_PARAMETERS se establece en EHSTOR_BANDMGR_NO_KEY, los datos de entrada del búfer del sistema no necesitan incluir una estructura 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 (DELETE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

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	La banda se eliminó 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 no es válida o la banda está bloqueada para escribir.
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

Se requiere una clave de autenticación para eliminar una banda sin realizar primero una eliminación. Para solicitar un borrado de banda, la marca DELBAND_ERASE_BEFORE_DELETE se establece en el miembro Flags de DELETE_BAND_PARAMETERS.

Después de eliminar una banda, todos los LBAs contenidos en la banda eliminada se devuelven a la banda global. Las condiciones de bloqueo de la banda global ahora se aplican a las LBAs devueltas a la banda global. Las LBAs devueltas a la banda global ahora están asociadas con la clave multimedia de la banda global y los datos cifrados en esos LBAs no son irrecuperables.

La banda eliminada permanece en la tabla de bandas del controlador de silo, pero se vuelve sin configurar. La clave de autenticación se restablece al valor predeterminado, los metadatos de banda y clave contienen ceros y los estados de bloqueo se revierten a PERSISTENT_UNLOCK. La banda ya está disponible para la reconfiguración con una solicitud de IOCTL_EHSTOR_BANDMGMT_CREATE_BAND .

La eliminación de una banda sin una era criptográfica no quitará la clave de cifrado de esa banda. Posteriormente es posible crear una banda con la misma configuración y identificador de banda que la banda eliminada. En este caso, los datos almacenados previamente en la banda y no se sobrescriben, ya que la eliminación de la banda anterior estará disponible. Para evitar esta situación, elimine la banda con la marca DELBAND_ERASE_BEFORE_DELETE establecida en DELETE_BAND_PARAMETERS.

El IOCTL_EHSTOR_BANDMGMT_DELETE_BAND no eliminará la banda global. Una solicitud para hacerlo devolverá STATUS_INVALID_PARAMETER.

Requisitos

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

Consulte también

DELETE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND