Funzione VideoPortGetRomImage (video.h)

Articolo
02/07/2025

Legge la memoria di sola lettura (ROM) del dispositivo.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] Unused1

Attualmente ignorato dal driver della porta video; deve essere impostato su NULL.

[in] Unused2

Attualmente ignorato dal driver della porta video; deve essere impostato su zero.

[in] Length

Numero di byte di dati ROM che il driver della porta video deve leggere e restituire o zero.

Valore restituito

VideoPortGetRomImage restituisce un puntatore a un buffer contenente i dati ROM (BIOS) del dispositivo in caso di esito positivo; in caso contrario, restituisce NULL per indicare che non è stata rilevata memoria sufficiente per l'operazione oppure non è stato possibile accedere al ROM del dispositivo.

Osservazioni

VideoPortGetRomImage non legge ROM usando il mapping di 0xC0000 legacy. Legge ROM che può essere individuato usando il metodo ACPI_METHOD_DISPLAY_ROM o il registro degli indirizzi di base ROM.

L'alias ACPI_METHOD_DISPLAY_ROM, definito in Dispmprt.h, rappresenta il metodo usato per ottenere l'immagine ROM BIOS. Questo metodo è obbligatorio quando l'immagine ROM viene archiviata in un formato proprietario, ad esempio il BIOS ROM di sistema. Questo metodo non è necessario se l'immagine ROM può essere letta tramite un'interfaccia PCI standard.

Il driver della porta video alloca un buffer di lunghezza byte e lo riempie con i dati letti dal ROM del dispositivo. Il driver della porta video legge sempre lunghezza byte dall'inizio della ROM del dispositivo.

Se un driver miniport chiama VideoPortGetRomImage più volte, il driver della porta video libera il buffer da una chiamata precedente prima di allocare e restituire un buffer nella chiamata corrente. Di conseguenza, un driver miniport deve fare riferimento solo al puntatore restituito da questa chiamata a VideoPortGetRomImage.

Il driver miniport può liberare il buffer allocato dal driver della porta video chiamando VideoPortGetRomImage con un Lunghezza pari a zero.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Desktop
intestazione	video.h (includere Video.h)
libreria	Videoprt.lib
dll	Videoprt.sys
IRQL	PASSIVE_LEVEL

Vedere anche

VideoPortScanRom

Condividi tramite