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 |