Compartir a través de

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)

  • Artículo

La solicitud IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES recupera las funcionalidades de seguridad agrupadas para un dispositivo de almacenamiento. El IOCTL devuelve las funcionalidades como una estructura BAND_MANAGEMENT_CAPABILITIES en el búfer del sistema.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Ninguno.

Longitud del búfer de entrada

Ninguno.

Búfer de salida

El búfer de salida de Irp-AssociatedIrp.SystemBuffer> contiene una estructura BAND_MANAGEMENT_CAPABILITIES.

Longitud del búfer de salida

Longitud de una estructura de BAND_MANAGEMENT_CAPABILITIES .

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 El dispositivo admite la administración de bandas y las funcionalidades de seguridad se devuelven en el búfer del sistema.
STATUS_INVALID_DEVICE_REQUEST La administración de bandas no se admite en el dispositivo de almacenamiento.
STATUS_INVALID_DEVICE_STATE El dispositivo proporciona compatibilidad con la administración de bandas, pero no en su configuración actual.
STATUS_BUFFER_OVERFLOW No se proporciona un búfer o su tamaño se establece en cero. El tamaño necesario se devuelve en el campo Información .
STATUS_BUFFER_TOO_SMALL El tamaño del búfer es demasiado pequeño para devolver la salida.

Comentarios

Un controlador o aplicación puede consultar el tamaño de 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_QUERY_CAPABILITIES 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 (incluya EhStorBandMgmt.h)

Consulte también

BAND_MANAGEMENT_CAPABILITIES