videoPortGetRomImage 函数 (video.h)

  • 项目

(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

视频端口驱动程序应读取并返回的 ROM 数据的字节数或零。

返回值

VideoPortGetRomImage 返回指向缓冲区的指针，该缓冲区包含设备的 ROM (BIOS) 成功时的数据;否则，返回 NULL ，指示操作的内存不足或无法访问设备的 ROM。

注解

VideoPortGetRomImage 不使用旧版0xC0000映射读取 ROM。 它读取可以使用 ACPI_METHOD_DISPLAY_ROM 方法或 ROM 基址寄存器发现的 ROM。

dispmprt.h 中定义的ACPI_METHOD_DISPLAY_ROM别名表示用于获取 BIOS ROM 映像的方法。 当 ROM 映像以专有格式（如系统 BIOS ROM）存储时，此方法是必需的。 如果可以通过标准 PCI 接口读取 ROM 映像，则不需要此方法。

视频端口驱动程序分配 长度 为字节的缓冲区，并使用从设备的 ROM 读取的数据填充该缓冲区。 视频端口驱动程序始终从设备的 ROM 开头读取 Length 字节。

如果微型端口驱动程序多次调用 VideoPortGetRomImage ，则视频端口驱动程序将从上一次调用中释放缓冲区，然后再在当前调用中分配和返回缓冲区。 因此，微型端口驱动程序必须仅引用此对 VideoPortGetRomImage 的调用返回的指针。

微型端口驱动程序可以通过调用长度为零的 VideoPortGetRomImage 来释放视频端口驱动程序分配的缓冲区。

要求

要求 值
最低受支持的客户端 在 Windows 2000 及更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 video.h (包括 Video.h)
Library Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

另请参阅

VideoPortScanRom