IOCTL_STORAGE_FIRMWARE_GET_INFO IOCTL (ntddstor.h)

Artigo
02/26/2024

Um driver pode usar IOCTL_STORAGE_FIRMWARE_GET_INFO para consultar um dispositivo de armazenamento para obter informações detalhadas de firmware. Uma chamada bem-sucedida retornará informações sobre revisões de firmware, status de atividade, bem como atributos de leitura/gravação para cada slot. A quantidade de dados retornados varia de acordo com o protocolo de armazenamento.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer de parâmetro em Irp->AssociatedIrp.SystemBuffer, que deve ser >= sizeof(STORAGE_HW_FIRMWARE_INFO_QUERY). O Irp->AssociatedIrp.SystemBuffer contém STORAGE_HW_FIRMWARE_INFO_QUERY dados que especificam o destino da solicitação. Parameters.DeviceIoControl.OutputBufferLength indica o número de bytes que podem ser gravados em Irp->AssociatedIrp.SystemBuffer. OutputBufferLength deve ser sizeof(STORAGE_HW_FIRMWARE_INFO) + sizeof(STORAGE_HW_FIRMWARE_SLOT_INFO) * (STORAGE_HW_FIRMWARE_INFO. SlotCount -1).

Comprimento do buffer de entrada

O comprimento de .

Buffer de saída

O driver retorna dados de consulta para o buffer em Irp-AssociatedIrp.SystemBuffer>. O buffer de saída deve conter uma estrutura STORAGE_HW_FIRMWARE_INFO e STORAGE_HW_FIRMWARE_SLOT_INFO para cada slot no dispositivo.

Comprimento do buffer de saída

O comprimento de .

Bloco de status

O campo Informações é definido como o número de bytes retornados. O campo Status é definido como STATUS_SUCCESS ou possivelmente para STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER ou STATUS_NOT_SUPPORTED.