Funzione VideoPortGetRomImage (video.h)

Articolo
08/08/2023

Legge la memoria (ROM) di sola lettura 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 è disponibile memoria sufficiente per l'operazione oppure non è stato possibile accedere alla ROM del dispositivo.

Commenti

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 della ROM.

L'alias ACPI_METHOD_DISPLAY_ROM, definito in Dispmprt.h, rappresenta il metodo usato per ottenere l'immagine ROM del BIOS. Questo metodo è necessario 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 byte di lunghezza e lo riempie con i dati letti dalla ROM del dispositivo. Il driver della porta video legge sempre i byte di lunghezza 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 una lunghezza pari a zero.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (include Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Vedi anche

VideoPortScanRom

Condividi tramite