IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES请求检索存储设备的带状安全功能。 IOCTL 将功能作为系统缓冲区中的 BAND_MANAGEMENT_CAPABILITIES 结构返回。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

无。

输入缓冲区长度

无。

输出缓冲区

Irp-AssociatedIrp.SystemBuffer> 处的输出缓冲区包含BAND_MANAGEMENT_CAPABILITIES结构。

输出缓冲区长度

BAND_MANAGEMENT_CAPABILITIES 结构的长度。

状态块

“信息”字段包含输出缓冲区中返回的字节数。 可以在“ 状态” 字段中返回以下值之一。

状态值	说明
STATUS_SUCCESS	设备支持带管理，安全功能在系统缓冲区中返回。
STATUS_INVALID_DEVICE_REQUEST	存储设备不支持带管理。
STATUS_INVALID_DEVICE_STATE	设备提供带管理支持，但不在其当前配置中。
STATUS_BUFFER_OVERFLOW	未提供缓冲区或其大小设置为零。 所需大小在 “信息 ”字段中返回。
STATUS_BUFFER_TOO_SMALL	缓冲区大小太小，无法返回输出。

注解

驱动程序或应用程序可以通过将请求的输出缓冲区设置为 NULL 并将输出大小设置为 0 来查询必要的输出缓冲区大小。 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES请求将返回，IoStatus 块的“状态”字段设置为 STATUS_BUFFER_OVERFLOW 并且“信息”字段将包含所需的缓冲区大小。

要求

要求	值
最低受支持的客户端	从Windows 8开始可用
标头	ehstorbandmgmt.h (包括 EhStorBandMgmt.h)

另请参阅

BAND_MANAGEMENT_CAPABILITIES