Função VideoPortGetRomImage (video.h)

Artigo
02/07/2025

Lê a ROM (memória somente leitura) do dispositivo.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetRomImage(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID Unused1,
  [in] IN ULONG Unused2,
  [in] IN ULONG Length
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo do driver de miniport.

[in] Unused1

Atualmente ignorado pelo driver de porta de vídeo; deve ser definido como NULL.

[in] Unused2

Atualmente ignorado pelo driver de porta de vídeo; deve ser definido como zero.

[in] Length

O número de bytes de dados ROM que o driver de porta de vídeo deve ler e retornar ou zero.

Valor de retorno

VideoPortGetRomImage retorna um ponteiro para um buffer que contém os dados DE ROM (BIOS) do dispositivo com êxito; caso contrário, retorna NULL para indicar que não havia memória suficiente para a operação ou a ROM do dispositivo não pôde ser acessada.

Observações

VideoPortGetRomImage não lê ROM usando o mapeamento de 0xC0000 herdado. Ele lê a ROM que pode ser descoberta usando o método ACPI_METHOD_DISPLAY_ROM ou o registro de endereço base de ROM.

O alias ACPI_METHOD_DISPLAY_ROM, definido em Dispmprt.h, representa o método usado para obter a imagem DE ROM do BIOS. Esse método é necessário quando a imagem ROM é armazenada em um formato proprietário, como a ROM do BIOS do sistema. Esse método não será necessário se a imagem ROM puder ser lida por meio de uma interface PCI padrão.

O driver de porta de vídeo aloca um buffer de Comprimento bytes e o preenche com dados lidos da ROM do dispositivo. O driver da porta de vídeo sempre lê Comprimento bytes desde o início da ROM do dispositivo.

Se um driver de miniporto chamar VideoPortGetRomImage várias vezes, o driver de porta de vídeo liberará o buffer de uma chamada anterior antes de alocar e retornar um buffer na chamada atual. Consequentemente, um driver de miniporto só deve referenciar o ponteiro retornado por essa chamada para VideoPortGetRomImage .

O driver de miniporto pode liberar o buffer alocado pelo driver de porta de vídeo chamando VideoPortGetRomImage com um Length de zero.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	video.h (inclua Video.h)
biblioteca	Videoprt.lib
de DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Consulte também

VideoPortScanRom

Compartilhar via