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)

Consulte también

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA