estructura SET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)

Los metadatos de una banda configurada se establecen en los parámetros de una estructura SET_BAND_METADATA_PARAMETERS . Esta estructura es la entrada de una solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA .

Sintaxis

typedef struct _SET_BAND_METADATA_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         MetadataOffset;
  ULONG         MetadataSize;
  ULONG         BufferOffset;
  ULONG         AuthKeyOffset;
} SET_BAND_METADATA_PARAMETERS, *PSET_BAND_METADATA_PARAMETERS;

Miembros

StructSize

Tamaño de esta estructura en bytes. Establezca en sizeof(SET_BAND_METADATA_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.

MetadataOffset

Desplazamiento desde el principio de la propiedad de metadatos de banda para establecer los nuevos datos.

MetadataSize

Longitud de bytes de metadatos que se van a establecer. Este tamaño está limitado por el valor de MetadataOffset restado del miembro BandMetadataSize de la estructura BAND_MANAGEMENT_CAPABILITIES .

BufferOffset

Desplazamiento, en bytes, desde el principio de SET_BAND_METADATA_PARAMETERS hasta la ubicación de los nuevos metadatos.

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_METADATA_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 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 AuthKeyOffset = 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_SET_BAND_METADATA.

Si BandID y BandStart se establecen en –1, el IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA establece los metadatos de la banda global.

El tamaño del almacén de metadatos de banda se encuentra en el miembro BandMetadataSize de BAND_MANAGEMENT_CAPABILITIES. Esta estructura se devuelve de una solicitud de IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES .

Los nuevos metadatos que se van a establecer para la banda se incluyen en el búfer del sistema para la solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA y siguen esta estructura en BufferOffset.

Requisitos

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

Consulte también

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA