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