estructura ERASE_BAND_PARAMETERS (ehstorbandmgmt.h)

Artículo
08/07/2023

La estructura ERASE_BAND_PARAMETERS contiene los criterios de selección de una banda que se va a borrar. Además, se puede establecer una nueva clave de autenticación. Esta estructura es la entrada de una solicitud de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Sintaxis

typedef struct _ERASE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;

Miembros

StructSize

Tamaño de esta estructura en bytes. Establézcalo en sizeof(ERASE_BAND_PARAMETERS).

Flags

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

Valor	Significado
ERASEBAND_AUTHKEY_CACHING_ENABLED	La nueva clave de autenticación de esta banda se almacena en caché, lo que permite la automatización de las operaciones posteriores.

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 inicial de bytes en el dispositivo de almacenamiento para iniciar una búsqueda de banda. Se intenta hacer coincidir una banda en o después de BandStart.

NewAuthKeyOffset

Desplazamiento, en bytes, de una estructura de AUTH_KEY que contiene la nueva clave de autorización para la banda. El desplazamiento es desde el principio de ERASE_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 Key. Si KeySize se establece 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 NewAuthKeyOffset = 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, bandID se usa como único criterio de selección para una coincidencia de banda. Si BandID == –1, BandStart se usa como criterio de coincidencia para seleccionar una banda. Si ninguna banda coincide con ninguno de los criterios de selección, se devuelve STATUS_INVALID_PARAMETER en el bloque IoStatus para IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.