Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las propiedades de ubicación de las bandas de un dispositivo de almacenamiento administrado por banda se modifican con la solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION.
Código principal
Búfer de entrada
El búfer de Irp->AssociatedIrp.SystemBuffer debe contener una estructura SET_BAND_LOCATION_PARAMETERS seguida de las estructuras AUTH_KEY y BAND_LOCATION_INFO.
Si el miembro AuthKeyOffset de SET_BAND_LOCATION_PARAMETERS está establecido en EHSTOR_BANDMGR_NO_KEY, los datos de entrada del búfer del sistema no necesitan incluir una estructura de AUTH_KEY.
Longitud del búfer de entrada
Parameters.DeviceIoControl.InputBufferLength indica el tamaño, en bytes, del búfer, que debe ser al menos tamaño de (SET_BAND_LOCATION_PARAMETERS) + tamaño de(AUTH_KEY) + tamaño de(BAND_LOCATION_INFO).
Búfer de salida
Ninguno.
Longitud del búfer de salida
Ninguno.
Bloque de estado
Se puede devolver uno de los siguientes valores en el campo estado de .
| Valor de estado | Descripción |
|---|---|
| STATUS_SUCCESS | Se cambiaron las propiedades de ubicación de la banda. |
| 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 entrada no es válido. |
| 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_ACCESS_DENIED | La clave de autenticación proporcionada no es válida. |
| STATUS_IO_DEVICE_ERROR | Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad. |
Observaciones
La operación no modifica los datos de lbAs que permanecen después de cambiar el tamaño. Además, no es necesario desmontar un volumen durante una operación de cambio de tamaño si el intervalo LBA que abarca el volumen permanece dentro de la banda después de cambiar el tamaño.
Los cambios realizados en la tabla de bandas por esta solicitud se confirman en el dispositivo de forma atómica antes de que se complete la solicitud IOCTL. Por lo tanto, se garantiza que la banda se modifica con todas sus propiedades establecidas o ninguna propiedad establecida en absoluto si se produce un error de alimentación o sistema.
El miembro BandSize de BAND_LOCATION_INFO debe ser mayor que 0. Este IOCTL no puede cambiar el tamaño de una banda a 0 para provocar la eliminación de una banda. Para eliminar una banda, se usa la solicitud IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.
Si BAND_LOCATION_INFO especifica propiedades para la banda global, BandStart debe establecerse en 0 y bandSize debe establecerse en –1.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8 |
| encabezado de | ehstorbandmgmt.h (include EhStorBandMgmt.h) |