Função VideoPortGetRomImage (video.h)
Lê a ROM (memória somente leitura) do dispositivo.
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetRomImage(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID Unused1,
[in] IN ULONG Unused2,
[in] IN ULONG Length
);
[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.
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.
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.
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 |