Fonction VideoPortGetRomImage (video.h)

Lit la mémoire en lecture seule (ROM) 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 avoir la valeur NULL.

[in] Unused2

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

[in] Length

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

Valeur retournée

VideoPortGetRomImage retourne un pointeur vers une mémoire tampon contenant les données ROM (BIOS) de l’appareil en cas de réussite ; dans le cas contraire, retourne la valeur NULL pour indiquer soit qu’il n’y a pas de mémoire suffisante pour l’opération, soit que la ROM de l’appareil n’est pas 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 BIOS ROM. Cette méthode est requise lorsque l’image ROM est stockée dans un format propriétaire tel que la ROM du 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 d’octets de longueur et la remplit de données lues à partir de la ROM de l’appareil. Le pilote de port vidéo lit toujours les octets de longueur à 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 renvoyer 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.

Configuration requise

Voir aussi

VideoPortScanRom