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 开头读取 长度 字节。

如果微型端口驱动程序多次调用 VideoPortGetRomImage,则视频端口驱动程序将在分配缓冲区并返回当前调用中的缓冲区之前释放上一个调用中的缓冲区。 因此,微型端口驱动程序只能引用此调用 VideoPortGetRomImage返回的指针。

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

要求

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

另请参阅

VideoPortScanRom