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
Header	ntddstor.h (Ntddstor.h を含む)