IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)

  • 项目

驱动程序可以使用 IOCTL_STORAGE_FIRMWARE_GET_INFO 来查询存储设备以获取详细的固件信息。 成功的调用将返回有关固件修订、活动状态以及每个插槽的读/写属性的信息。 返回的数据量因存储协议而异。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

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

STORAGE_HW_FIRMWARE_ACTIVATE

STORAGE_HW_FIRMWARE_DOWNLOAD

STORAGE_HW_FIRMWARE_INFO

STORAGE_HW_FIRMWARE_INFO_QUERY

STORAGE_HW_FIRMWARE_SLOT_INFO