estructura GET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)
Los metadatos de una banda configurada se recuperan según los parámetros de una estructura 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. Para usar BandStart y BandSize en lugar de BandId para seleccionar una banda, establezca BandId = (ULONG) –1.
BandStart
Ubicación de bytes inicial 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 de la que se van a recuperar datos.
MetadataSize
Longitud de bytes de metadatos que se van a recuperar.
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, se usa BandID como únicos criterios de selección para una coincidencia de banda. Si BandID == –1, se usa BandStart como criterio de coincidencia para seleccionar una banda. Si ninguna banda coincide con ninguno de los criterios de selección, STATUS_INVALID_PARAMETER se devuelve en el bloque 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 | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8 |
| Encabezado | ehstorbandmgmt.h (include EhStorBandMgmt.h) |