Fungsi VideoPortGetRomImage (video.h)

Artikel
03/01/2024

Membaca memori baca-saja (ROM) perangkat.

Sintaks

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetRomImage(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID Unused1,
  [in] IN ULONG Unused2,
  [in] IN ULONG Length
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat driver miniport.

[in] Unused1

Saat ini diabaikan oleh driver port video; harus diatur ke NULL.

[in] Unused2

Saat ini diabaikan oleh driver port video; harus diatur ke nol.

[in] Length

Baik jumlah byte data ROM yang harus dibaca dan dikembalikan oleh driver port video, atau nol.

Nilai kembali

VideoPortGetRomImage mengembalikan pointer ke buffer yang berisi data ROM (BIOS) perangkat saat berhasil; jika tidak, mengembalikan NULL untuk menunjukkan bahwa tidak ada memori yang cukup untuk operasi, atau ROM perangkat tidak dapat diakses.

Keterangan

VideoPortGetRomImage tidak membaca ROM menggunakan warisan 0xC0000 pemetaan. Ini membaca ROM yang dapat ditemukan menggunakan metode ACPI_METHOD_DISPLAY_ROM atau register alamat dasar ROM.

Alias ACPI_METHOD_DISPLAY_ROM, yang didefinisikan dalam Dispmprt.h, mewakili metode yang digunakan untuk mendapatkan gambar BIOS ROM. Metode ini diperlukan ketika gambar ROM disimpan dalam format kepemilikan seperti SISTEM BIOS ROM. Metode ini tidak diperlukan jika gambar ROM dapat dibaca melalui antarmuka PCI standar.

Driver port video mengalokasikan buffer Byte Panjang dan mengisinya dengan data yang dibaca dari ROM perangkat. Driver port video selalu membaca Byte panjang dari awal ROM perangkat.

Jika driver miniport memanggil VideoPortGetRomImage beberapa kali, driver port video akan membebaskan buffer dari panggilan sebelumnya sebelum mengalokasikan dan mengembalikan buffer dalam panggilan saat ini. Akibatnya, driver miniport hanya boleh mereferensikan pointer yang dikembalikan oleh panggilan ini ke VideoPortGetRomImage.

Driver miniport dapat membebaskan buffer yang dialokasikan oleh driver port video dengan memanggil VideoPortGetRomImage dengan Panjang nol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Lihat juga

VideoPortScanRom

Bagikan melalui