VideoPortGetRomImage, fonction (video.h)

Article
02/07/2025

Lit la mémoire en lecture seule de l’appareil.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] Unused1

Actuellement ignoré par le pilote de port vidéo ; doit être défini sur NULL .

[in] Unused2

Actuellement ignoré par le pilote de port vidéo ; doit être défini sur zéro.

[in] Length

Nombre d’octets de données ROM que le pilote de port vidéo doit lire et retourner, ou zéro.

Valeur de retour

VideoPortGetRomImage retourne un pointeur vers une mémoire tampon contenant les données DE ROM (BIOS) de l’appareil en cas de réussite ; sinon, retourne NULL pour indiquer qu’il n’y avait pas de mémoire insuffisante pour l’opération, ou que le ROM de l’appareil n’a pas pu être accessible.

Remarques

VideoPortGetRomImage ne lit pas de ROM à l’aide du mappage de 0xC0000 hérité. Il lit le ROM qui peut être découvert à l’aide de la méthode ACPI_METHOD_DISPLAY_ROM ou du registre d’adresses de base rom.

L’alias ACPI_METHOD_DISPLAY_ROM, défini dans Dispmprt.h, représente la méthode utilisée pour obtenir l’image DE ROM BIOS. Cette méthode est requise lorsque l’image ROM est stockée dans un format propriétaire tel que le ROM BIOS système. Cette méthode n’est pas nécessaire si l’image ROM peut être lue via une interface PCI standard.

Le pilote de port vidéo alloue une mémoire tampon de Longueur octets et le remplit avec des données lues à partir de la ROM de l’appareil. Le pilote de port vidéo lit toujours Longueur octets à partir du début de la ROM de l’appareil.

Si un pilote miniport appelle VideoPortGetRomImage plusieurs fois, le pilote de port vidéo libère la mémoire tampon d’un appel précédent avant d’allouer et de retourner une mémoire tampon dans l’appel actuel. Par conséquent, un pilote miniport doit uniquement référencer le pointeur retourné par cet appel à VideoPortGetRomImage.

Le pilote miniport peut libérer la mémoire tampon allouée par le pilote de port vidéo en appelant VideoPortGetRomImage avec une Longueur de zéro.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	video.h (include Video.h)
bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Voir aussi

VideoPortScanRom

Partager via