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 等專屬格式儲存時，需要這個方法。 如果 ROM 映像可以透過標準 PCI 介面讀取，則不需要這個方法。
視訊埠驅動程式會配置 長度 位元組的緩衝區，並填入從裝置 ROM 讀取的數據。 視訊埠驅動程式一律會從裝置的 ROM 開頭讀取 Length 位元組。
如果迷你埠驅動程式多次呼叫 VideoPortGetRomImage ，則視訊埠驅動程式會在配置並傳回目前呼叫中的緩衝區之前，先從先前呼叫釋出緩衝區。 因此，迷你埠驅動程式只能參考此 VideoPortGetRomImage 呼叫所傳回的指標。
迷你埠驅動程式可以呼叫 Length 為零的 VideoPortGetRomImage，釋放視訊埠驅動程式所配置的緩衝區。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
| 目標平台 | 桌面 |
| 標頭 | video.h (包含 Video.h) |
| 程式庫 | Videoprt.lib |
| Dll | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |