estructura SET_BAND_LOCATION_PARAMETERS (ehstorbandmgmt.h)

Artículo
06/08/2024

La estructura SET_BAND_LOCATION_PARAMETERS especifica los parámetros para establecer las propiedades de ubicación de una banda en un dispositivo de almacenamiento para una solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION .

Sintaxis

typedef struct _SET_BAND_LOCATION_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
  ULONG         BandLocationInfoOffset;
} SET_BAND_LOCATION_PARAMETERS, *PSET_BAND_LOCATION_PARAMETERS;

Miembros

StructSize

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

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.

AuthKeyOffset

Desplazamiento, en bytes, de una estructura de AUTH_KEY que contiene la clave de autorización para la banda. El desplazamiento es desde el principio de SET_BAND_LOCATION_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 autorización predeterminada en la banda, establezca AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

BandLocationInfoOffset

Desplazamiento, en bytes, de una estructura BAND_LOCATION_INFO . El desplazamiento es desde el principio de SET_BAND_LOCATION_PARAMETERS.

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_SET_BAND_LOCATION.

Si BandID y BandStart se establecen en –1, la solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION cambiará las propiedades de la banda global.