IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)

Статья
02/07/2025

Драйвер может использовать IOCTL_STORAGE_FIRMWARE_GET_INFO для запроса устройства хранения подробных сведений о встроенном ПО. Успешный вызов возвращает сведения о исправлениях встроенного ПО, состоянии действия, а также атрибутах чтения и записи для каждого слота. Объем возвращаемых данных зависит от протокола хранения.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Parameters.DeviceIoControl.InputBufferLength указывает размер буфера параметров в Irp->AssociatedIrp.SystemBuffer, который должен быть >= размер(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 структуру для каждого слота на устройстве.

Длина выходного буфера

Длина .

Блок состояния

В поле Information задано количество возвращаемых байтов. Поле состояния имеет значение STATUS_SUCCESS или, возможно, STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER или STATUS_NOT_SUPPORTED.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
заголовка	ntddstor.h (include Ntddstor.h)