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

Статья
02/07/2025

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

Синтаксис

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. Этот метод требуется, если образ РОМ хранится в закрытом формате, например системный ДИСК BIOS. Этот метод не нужен, если образ РОМ можно считывать через стандартный интерфейс PCI.

Драйвер видеопорта выделяет буфер длины байтов и заполняет его данными, считываемыми из диска устройства. Драйвер видеопорта всегда считывает длину байтов с начала РОМ устройства.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
целевая платформа	Настольный
заголовка	video.h (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

См. также

VideoPortScanRom

Поделиться через