共用方式為


IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)

驅動程式可以使用 IOCTL_STORAGE_FIRMWARE_GET_INFO 來查詢存儲設備以取得詳細的韌體資訊。 成功的呼叫會傳回韌體修訂、活動狀態,以及每個位置的讀取/寫入屬性的相關信息。 傳回的數據量會根據記憶體通訊協定而有所不同。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

Parameters.DeviceIoControl.InputBufferLength 會指出 Irp->AssociatedIrp.SystemBuffer的參數緩衝區大小,>= sizeofSTORAGE_HW_FIRMWARE_INFO_QUERY)。 Irp->AssociatedIrp.SystemBuffer 包含指定要求目標的 STORAGE_HW_FIRMWARE_INFO_QUERY 數據。 Parameters.DeviceIoControl.OutputBufferLength 指出可以 寫入 Irp->AssociatedIrp.SystemBuffer的位元組數目。 OutputBufferLength 必須 sizeofSTORAGE_HW_FIRMWARE_INFO) + sizeofSTORAGE_HW_FIRMWARE_SLOT_INFO) * (STORAGE_HW_FIRMWARE_INFO.SlotCount -1)。

輸入緩衝區長度

的長度。

輸出緩衝區

驅動程式會將查詢資料傳回緩衝區,Irp->AssociatedIrp.SystemBuffer。 輸出緩衝區應該包含裝置上每個位置的 STORAGE_HW_FIRMWARE_INFOSTORAGE_HW_FIRMWARE_SLOT_INFO 結構。

輸出緩衝區長度

的長度。

狀態區塊

[資訊] 字段會設定為傳回的位元元組數。 [狀態] 字段會設定為 [STATUS_SUCCESS],或可能設定為 [STATUS_INVALID_DEVICE_REQUEST]、[STATUS_INVALID_PARAMETER] 或 [STATUS_NOT_SUPPORTED]。

要求

要求 價值
最低支援的用戶端 Windows 10
支援的最低伺服器 Windows Server 2016
標頭 ntddstor.h (include 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