VideoPortGetRomImage-Funktion (video.h)

Liest den schreibgeschützten Arbeitsspeicher (ROM) des Geräts.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] Unused1

Wird derzeit vom Videoporttreiber ignoriert; sollte auf NULL festgelegt werden.

[in] Unused2

Wird derzeit vom Videoporttreiber ignoriert; sollte auf 0 (null) festgelegt werden.

[in] Length

Entweder die Anzahl der Byte der ROM-Daten, die der Videoporttreiber lesen und zurückgeben soll, oder null.

Rückgabewert

VideoPortGetRomImage gibt einen Zeiger auf einen Puffer zurück, der die ROM-Daten (BIOS) des Geräts bei Erfolg enthält. Gibt andernfalls NULL zurück, um anzugeben, dass für den Vorgang nicht genügend Arbeitsspeicher vorhanden war oder auf das ROM des Geräts nicht zugegriffen werden konnte.

Hinweise

VideoPortGetRomImage liest rom nicht mit der Legacy-0xC0000 zuordnung. Es liest ROM, das mithilfe der ACPI_METHOD_DISPLAY_ROM-Methode oder des ROM-Basisadressregisters ermittelt werden kann.

Der in Dispmprt.h definierte ACPI_METHOD_DISPLAY_ROM Alias stellt die Methode dar, die zum Abrufen des BIOS-ROM-Images verwendet wird. Diese Methode ist erforderlich, wenn das ROM-Image in einem proprietären Format wie dem System-BIOS-ROM gespeichert wird. Diese Methode ist nicht erforderlich, wenn das ROM-Image über eine PCI-Standardschnittstelle gelesen werden kann.

Der Videoporttreiber weist einen Puffer von Längenbytes zu und füllt ihn mit Daten, die aus dem ROM des Geräts gelesen werden. Der Videoporttreiber liest die Längenbytes immer vom Anfang des ROM des Geräts.

Wenn ein Miniporttreiber VideoPortGetRomImage mehrmals aufruft , gibt der Videoporttreiber den Puffer von einem vorherigen Aufruf frei, bevor ein Puffer im aktuellen Aufruf zugewiesen und zurückgegeben wird. Folglich darf ein Miniporttreiber nur auf den Zeiger verweisen, der von diesem Aufruf von VideoPortGetRomImage zurückgegeben wird.

Der Miniporttreiber kann den vom Videoporttreiber zugeordneten Puffer freigeben, indem er VideoPortGetRomImage mit einer Länge von 0 (null) aufruft.

Anforderungen

Weitere Informationen

VideoPortScanRom