Função VideoPortGetRomImage (video.h)

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 de dispositivo do driver de miniport.

[in] Unused1

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

[in] Unused2

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

[in] Length

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

Retornar valor

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.

Comentários

VideoPortGetRomImage não lê ROM usando o mapeamento de 0xC0000 herdado. Ele lê ROM que pode ser descoberto usando o método ACPI_METHOD_DISPLAY_ROM ou o registro de endereço base 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 o BIOS ROM 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 da porta de vídeo aloca um buffer de bytes de comprimento e o preenche com dados lidos da ROM do dispositivo. O driver da porta de vídeo sempre lê Bytes de comprimento desde o início da ROM do dispositivo.

Se um driver de miniporto chamar VideoPortGetRomImage várias vezes, o driver da 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 miniporte só deve referenciar o ponteiro retornado por essa chamada para VideoPortGetRomImage.

O driver de miniporte pode liberar o buffer alocado pelo driver da porta de vídeo chamando VideoPortGetRomImage com um Comprimento de zero.

Requisitos

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

Confira também

VideoPortScanRom