IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)
驱动程序可以使用 IOCTL_STORAGE_FIRMWARE_GET_INFO 来查询存储设备以获取详细的固件信息。 成功的调用将返回有关固件修订、活动状态以及每个插槽的读/写属性的信息。 返回的数据量因存储协议而异。
主要代码
输入缓冲区
Parameters.DeviceIoControl.InputBufferLength 指示 Irp->AssociatedIrp.SystemBuffer 的参数缓冲区的大小（以字节为单位），该缓冲区必须 >= sizeof (STORAGE_HW_FIRMWARE_INFO_QUERY) 。 Irp->AssociatedIrp.SystemBuffer 包含指定请求目标的 STORAGE_HW_FIRMWARE_INFO_QUERY 数据。 Parameters.DeviceIoControl.OutputBufferLength 指示可写入 Irp->AssociatedIrp.SystemBuffer 的字节数。 OutputBufferLength 的 size 必须为 (STORAGE_HW_FIRMWARE_INFO) + sizeof (STORAGE_HW_FIRMWARE_SLOT_INFO) * (STORAGE_HW_FIRMWARE_INFO。SlotCount -1) 。输入缓冲区长度
的长度。
输出缓冲区
驱动程序将查询数据返回到 Irp-AssociatedIrp.SystemBuffer> 处的缓冲区。 输出缓冲区应包含设备上每个槽 的STORAGE_HW_FIRMWARE_INFO 和 STORAGE_HW_FIRMWARE_SLOT_INFO 结构。
输出缓冲区长度
的长度。
状态块
“ 信息” 字段设置为返回的字节数。 “ 状态” 字段设置为STATUS_SUCCESS，或者可能设置为STATUS_INVALID_DEVICE_REQUEST、STATUS_INVALID_PARAMETER或STATUS_NOT_SUPPORTED。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10 |
| 最低受支持的服务器 | Windows Server 2016 |
| 标头 | ntddstor.h (包括 Ntddstor.h) |
另请参阅
IOCTL_STORAGE_FIRMWARE_ACTIVATE
IOCTL_STORAGE_FIRMWARE_DOWNLOAD