estructura GET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)
Los metadatos de una banda configurada se recuperan según los parámetros de una estructura de GET_BAND_METADATA_PARAMETERS. Esta estructura es la entrada de una solicitud de IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA.
Sintaxis
typedef struct _GET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;
Miembros
StructSize
Tamaño de esta estructura en bytes. Establezca en sizeof(GET_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. 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 en 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 desde la que recuperar datos.
MetadataSize
Longitud de bytes de metadatos que se van a recuperar.
Observaciones
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, BandStart se usa como criterios 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 de IoStatus para IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA.
Si BandID y BandStart se establecen en –1, el IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA devuelve metadatos para la banda global.
Si IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA se realizó correctamente, Parameters.DeviceIoControl.InputBufferLength es igual al valor de MetadataSize.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8 |
| encabezado de | ehstorbandmgmt.h (include EhStorBandMgmt.h) |