IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)

Articolo
02/29/2024

Un driver può usare IOCTL_STORAGE_FIRMWARE_GET_INFO per eseguire query su un dispositivo di archiviazione per ottenere informazioni dettagliate sul firmware. Una chiamata riuscita restituirà informazioni sulle revisioni del firmware, sullo stato dell'attività e sugli attributi di lettura/scrittura per ogni slot. La quantità di dati restituiti varia in base al protocollo di archiviazione.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer dei parametri in Irp->AssociatedIrp.SystemBuffer, che deve essere >= sizeof(STORAGE_HW_FIRMWARE_INFO_QUERY). Irp->AssociatedIrp.SystemBuffer contiene STORAGE_HW_FIRMWARE_INFO_QUERY dati che specificano la destinazione della richiesta. Parameters.DeviceIoControl.OutputBufferLength indica il numero di byte che possono essere scritti in Irp->AssociatedIrp.SystemBuffer. OutputBufferLength deve essere sizeof(STORAGE_HW_FIRMWARE_INFO) + sizeof(STORAGE_HW_FIRMWARE_SLOT_INFO) * (STORAGE_HW_FIRMWARE_INFO. SlotCount -1).

Lunghezza del buffer di input

Lunghezza di .

Buffer di output

Il driver restituisce dati di query al buffer in Irp-AssociatedIrp.SystemBuffer>. Il buffer di output deve contenere una struttura STORAGE_HW_FIRMWARE_INFO e STORAGE_HW_FIRMWARE_SLOT_INFO per ogni slot nel dispositivo.

Lunghezza del buffer di output

Lunghezza di .

Blocco dello stato

Il campo Informazioni viene impostato sul numero di byte restituiti. Il campo Stato è impostato su STATUS_SUCCESS o su STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER o STATUS_NOT_SUPPORTED.