IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)

Статья
08/07/2023

Драйвер может использовать 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 должен иметь значение sizeof(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)