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) |