IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS IOCTL (ehstorbandmgmt.h)

Esta IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS solicitud se envía para recuperar la lista de bandas de un dispositivo de almacenamiento bajo administración de bandas. La información de bandas se devuelve en una tabla de entradas de banda que incluye la ubicación de banda y las propiedades de seguridad.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El búfer de Irp-AssociatedIrp.SystemBuffer> debe contener una estructura de ENUMERATE_BANDS_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 (ENUMERATE_BANDS_PARAMETERS).

Búfer de salida

El búfer de Irp-AssociatedIrp.SystemBuffer> contiene una estructura de BAND_TABLE seguida de entradas de banda BandTableEntryCount.

Longitud del búfer de salida

Longitud de una estructura de BAND_TABLE seguida de entradas de banda BandTableEntryCount .

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	Se desactivaron las características de seguridad en el dispositivo de almacenamiento.
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 configuran bandas para los parámetros de enumeración proporcionados.
STATUS_BUFFER_OVERFLOW	No se proporciona un búfer ni su tamaño establecido en cero. El tamaño requerido se devuelve en el campo Información .
STATUS_IO_DEVICE_ERROR	Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad.
STATUS_BUFFER_TOO_SMALL	El búfer de salida proporcionado no es lo suficientemente grande como para contener los datos de salida devueltos.

Comentarios

Un controlador o aplicación puede consultar el tamaño del búfer de salida necesario estableciendo el búfer de salida para la solicitud en NULL y el tamaño de salida en 0. La solicitud de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS devolverá con el campo Estado del bloque IoStatus establecido en STATUS_BUFFER_OVERFLOW y el campo Información contendrá el tamaño de búfer necesario.

Requisitos

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

Consulte también

BAND_TABLE

ENUMERATE_BANDS_PARAMETERS