IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES control code

The IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES request retrieves the banded security capabilities for a storage device. The IOCTL returns the capabilities as a BAND_MANAGEMENT_CAPABILITIES structure in the system buffer.

Input Parameters

None.

Output Parameters

The output buffer at Irp->AssociatedIrp.SystemBuffer contains a BAND_MANAGEMENT_CAPABILITIES structure.

I/O Status Block

The Information field contains the number of bytes returned in the output buffer. One of the following values can be returned in the Status field.

Status ValueDescription
STATUS_SUCCESSThe device supports band management and the security capabilities are returned in the system buffer.
STATUS_INVALID_DEVICE_REQUESTBand management is not supported on the storage device.
STATUS_INVALID_DEVICE_STATEThe device provides band management support but not in its present configuration.
STATUS_BUFFER_OVERFLOWA buffer is not provided or its size is set to zero. The required size is returned in the Information field.
STATUS_BUFFER_TOO_SMALLThe buffer size is too small to return the output.

 

Remarks

A driver or application can query for the necessary output buffer size by setting the output buffer for the request to NULL and the output size to 0. The IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES request will return with the Status field of the IoStatus block set to STATUS_BUFFER_OVERFLOW and the Information field will contain the required buffer size.

Requirements

Version

Available starting with Windows 8

Header

EhStorBandMgmt.h (include EhStorBandMgmt.h)

See also

BAND_MANAGEMENT_CAPABILITIES

 

 

Send comments about this topic to Microsoft

Show: