estructura DELETE_BAND_PARAMETERS (ehstorbandmgmt.h)

Artículo
02/29/2024

Una banda configurada se elimina según los parámetros de una estructura de DELETE_BAND_PARAMETERS . Esta estructura es la entrada de una solicitud de IOCTL_EHSTOR_BANDMGMT_DELETE_BAND .

Sintaxis

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

Miembros

StructSize

Tamaño de esta estructura en bytes. Establezca en sizeof(DELETE_BAND_PARAMETERS).

Flags

Eliminar marcas de operación. Este valor es una combinación OR bit a bit de lo siguiente.

Valor	Significado
DELBAND_ERASE_BEFORE_DELETE	Realice una borrado criptográfico de los datos de propiedad de banda antes de eliminarlos.

Reserved

Reservado.

BandId

Identificador de una sola banda para la que se va a devolver información. BandSize debe ser 0 cuando se selecciona una sola banda con BandId. Para usar BandStart y BandSize en lugar de BandId para seleccionar una banda, establezca BandId = (ULONG) –1.

BandStart

Ubicación de bytes inicial en el dispositivo de almacenamiento para iniciar una búsqueda de banda. Se intenta hacer coincidir una banda en o después de BandStart.

AuthKeyOffset

Desplazamiento, en bytes, de una estructura de AUTH_KEY que contiene la clave de autorización de la banda. El desplazamiento es desde el principio de DELETE_BAND_PARAMETERS. 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;

KeySize

Tamaño de la clave, en bytes, de los datos de clave en Clave. Si KeySize está establecido en 0, se usa una clave predeterminada.

Clave

Matriz de bytes de longitud variable que contiene los datos de clave.

Para especificar una clave de autenticación predeterminada en la banda, establezca AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Si Flags contiene DELBAND_ERASE_BEFORE_DELETE, AuthKeyOffset debe establecerse en EHSTOR_BANDMGR_NO_KEY.

Comentarios

La prioridad se da a BandID para la selección de banda. Si BandID es mayor que 0 y BandID es menor que el miembro MaxBandCount de BAND_MANAGEMENT_CAPABILITIES, se usa BandID como únicos criterios de selección para una coincidencia de banda. Si BandID == –1, se usa BandStart como criterio de coincidencia para seleccionar una banda. Si ninguna banda coincide con ninguno de los criterios de selección, STATUS_INVALID_PARAMETER se devuelve en el bloque IoStatus para IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Si DELBAND_ERASE_BEFORE_DELETE se establece en Marcas, no se necesita una clave de autenticación para eliminar la banda. Si no se establece esta marca, la clave de autenticación actual debe incluirse en AuthKeyOffset.