IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

Los metadatos asociados a una banda se recuperan con una solicitud de IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA . Los metadatos de una banda sirven como área de datos para una aplicación de administrador de claves.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El búfer de entrada de Irp-AssociatedIrp.SystemBuffer> debe contener una estructura de GET_BAND_METADATA_PARAMETERS.

Longitud del búfer de entrada

Parameters.DeviceIoControl.InputBufferLength indica el tamaño, en bytes, del búfer, que debe ser al menos sizeof (GET_BAND_METADATA_PARAMETERS).

Búfer de salida

El búfer de salida de Irp-AssociatedIrp.SystemBuffer> contiene una matriz de bytes de metadatos de banda especificados por GET_BAND_METADATA_PARAMETERS.

Longitud del búfer de salida

Longitud de una estructura de GET_BAND_METADATA_PARAMETERS .

Bloque de estado

El campo Información contiene el número de bytes devueltos en el búfer de salida. Se puede devolver uno de los valores siguientes en el campo Estado .

Valor de estado	Descripción
STATUS_SUCCESS	Los metadatos se devolvieron en el búfer del sistema.
STATUS_INVALID_DEVICE_REQUEST	El dispositivo de almacenamiento no admite la administración de bandas.
STATUS_INVALID_BUFFER_SIZE	El tamaño del búfer de salida es incorrecto.
STATUS_INVALID_PARAMETER	La información del búfer de entrada no es válida.
STATUS_NOT_FOUND	No se encontró la banda para los criterios de selección proporcionados.
STATUS_IO_DEVICE_ERROR	Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad.

Comentarios

La autenticación para este IOCTL no es necesaria y no se incluye una clave de autenticación como entrada.

Requisitos

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

Consulte también

BAND_LOCATION_INFO

BAND_SECURITY_INFO

CREATE_BAND_PARAMETERS