Функция VideoPortGetRomImage (video.h)

Считывает память устройства, доступную только для чтения (ПЗУ).

Синтаксис

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

Параметры

[in] HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

[in] Unused1

В настоящее время игнорируется драйвером видеопорта; для параметра должно быть задано значение NULL.

[in] Unused2

В настоящее время игнорируется драйвером видеопорта; значение должно быть равно нулю.

[in] Length

Количество байтов данных ПЗУ, которые должен считывать и возвращать драйвер видеопорта, или ноль.

Возвращаемое значение

VideoPortGetRomImage возвращает указатель на буфер, содержащий данные ОЗУ (BIOS) устройства об успешном выполнении; в противном случае возвращает значение NULL , указывающее, что недостаточно памяти для операции или не удалось получить доступ к ПЗУ устройства.

Комментарии

VideoPortGetRomImage не считывает ПЗУ с помощью устаревшего сопоставления 0xC0000. Он считывает диск, который можно обнаружить с помощью метода ACPI_METHOD_DISPLAY_ROM или регистра базового адреса ПЗУ.

Псевдоним ACPI_METHOD_DISPLAY_ROM, определенный в Dispmprt.h, представляет метод, используемый для получения образа BIOS ROM. Этот метод требуется, если образ ПЗУ хранится в закрытом формате, например системном BIOS ROM. Этот метод не требуется, если образ ПЗУ можно считывать через стандартный интерфейс PCI.

Драйвер видеопорта выделяет буфер длиной в байтах и заполняет его данными, считываемыми из ПЗУ устройства. Драйвер видеопорта всегда считывает байты длины с начала ПЗУ устройства.

Если драйвер мини-порта вызывает VideoPortGetRomImage несколько раз, драйвер видеопорта освободит буфер от предыдущего вызова перед выделением и возвратом буфера в текущем вызове. Следовательно, драйвер мини-порта должен ссылаться только на указатель, возвращенный этим вызовом VideoPortGetRomImage.

Драйвер мини-порта может освободить буфер, выделенный драйвером видеопорта, вызвав VideoPortGetRomImage с нулевой длиной .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	video.h (включить Video.h)
Библиотека	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

См. также раздел

VideoPortScanRom