Función VideoPortGetRomImage (video.h)

Lee la memoria de solo lectura (ROM) del dispositivo.

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión del dispositivo del controlador de miniporte.

[in] Unused1

Actualmente ignorada por el controlador de puerto de vídeo; debe establecerse en NULL.

[in] Unused2

Actualmente ignorada por el controlador de puerto de vídeo; debe establecerse en cero.

[in] Length

Número de bytes de datos ROM que el controlador de puerto de vídeo debe leer y devolver, o cero.

Valor devuelto

VideoPortGetRomImage devuelve un puntero a un búfer que contiene los datos rom (BIOS) del dispositivo en caso correcto; de lo contrario, devuelve NULL para indicar que no había memoria suficiente para la operación o no se pudo tener acceso a la ROM del dispositivo.

Comentarios

VideoPortGetRomImage no lee ROM mediante la asignación de 0xC0000 heredada. Lee rom que se puede detectar mediante el método ACPI_METHOD_DISPLAY_ROM o el registro de direcciones base rom.

El alias ACPI_METHOD_DISPLAY_ROM, definido en Dispmprt.h, representa el método utilizado para obtener la imagen rom del BIOS. Este método es necesario cuando la imagen rom se almacena en un formato propietario, como la ROM del BIOS del sistema. Este método no es necesario si la imagen rom se puede leer a través de una interfaz PCI estándar.

El controlador de puerto de vídeo asigna un búfer de bytes length y lo rellena con datos leídos desde la ROM del dispositivo. El controlador de puerto de vídeo siempre lee Bytes de longitud desde el principio de la ROM del dispositivo.

Si un controlador de minipuerto llama a VideoPortGetRomImage varias veces, el controlador de puerto de vídeo liberará el búfer de una llamada anterior antes de asignar y devolver un búfer en la llamada actual. Por lo tanto, un controlador de minipuerto solo debe hacer referencia al puntero devuelto por esta llamada a VideoPortGetRomImage.

El controlador de minipuerto puede liberar el búfer asignado por el controlador de puerto de vídeo llamando a VideoPortGetRomImage con una longitud de cero.

Requisitos

Consulte también

VideoPortScanRom