PVIDEO_HW_RESET_HW fungsi panggilan balik (video.h)

Artikel
08/07/2023

HwVidResetHw mengatur ulang adaptor ke mode karakter.

Sintaks

PVIDEO_HW_RESET_HW PvideoHwResetHw;

BOOLEAN PvideoHwResetHw(
  PVOID HwDeviceExtension,
  ULONG Columns,
  ULONG Rows
)
{...}

Parameter

HwDeviceExtension

Arahkan ke area penyimpanan per adaptor driver miniport. Untuk informasi selengkapnya, lihat Ekstensi Perangkat.

Columns

Menentukan jumlah kolom mode yang akan disiapkan.

Rows

Menentukan jumlah baris mode yang akan disiapkan.

Nilai kembali

HwVidResetHw harus mengembalikan TRUE jika benar-benar mengatur ulang adaptor ke mode karakter yang diberikan. Jika tidak, ini harus mengembalikan FALSE untuk menunjukkan bahwa HAL harus melakukan panggilan BIOS jenis INT10 dan MODE3 yang setara setelah HwVidResetHw mengembalikan kontrol.

Keterangan

Driver miniport video harus memiliki fungsi HwVidResetHw jika adaptornya tidak dapat direset ke keadaan yang sepenuhnya diinisialisasi tanpa hard boot komputer. Misalnya, jika kode inisialisasi ROM adaptor tidak dapat mengatur ulang status adaptor ke mode boot-up, driver miniport harus memiliki fungsi HwVidResetHw . Alasan lain driver miniport harus mengimplementasikan fungsi ini adalah untuk membersihkan garis gangguan adaptor ketika adaptor dimatikan, sehingga menghindari gangguan saat sistem booting berikutnya.

HAL memanggil HwVidResetHw jika sistem akan mengalami crash, sehingga HAL dapat menampilkan informasi di layar saat sistem sedang dimatikan. Panggilan ini dapat terjadi di IRQL apa pun, dan driver harus siap untuk menanganinya kapan saja. HAL juga memanggil HwVidResetHw tepat sebelum komputer di-boot ulang ketika boot lunak terjadi.

Sebagian besar driver miniport harus menyediakan fungsi ini, kecuali untuk driver adaptor yang diatur ulang ke mode karakter standar VGA pada penerimaan perintah INT10, mode3-type.

HwVidResetHw mengatur ulang adaptor ke mode karakter, sesuai dengan nilai Kolom dan Baris yang diberikan. Namun, karena sistem dimatikan, HwVidResetHw tidak dapat memanggil BIOS atau kode yang dapat diuji. HwVidResetHw hanya boleh memanggil fungsi VideoPortRead/WritePortXxx dan/atau VideoPortRead/WriteRegisterXxx . (Lihat Fungsi yang Diekspor oleh Driver Port Video.)

Jika HwVidResetHw tidak dapat mengubah mode adaptor hanya dengan memprogram register adapter, HwVidResetHw dapat mengatur nilai yang sesuai dalam register adaptor dan mengembalikan FALSE. Hal ini menyebabkan HAL melakukan operasi jenis INT10 yang diperluas untuk mengatur ulang adaptor video ke mode karakter.

HwVidResetHw tidak boleh memanggil VideoPortInt10. Fungsi HwVidStartIO driver miniport dipanggil dengan IOCTL_VIDEO_RESET_DEVICE VRP untuk mengatur ulang adaptor setiap kali program Display digunakan untuk menguji atau mengubah mode tampilan grafis, bukan fungsi HwVidResetHw driver miniport.

HwVidResetHw tidak boleh dibuat dapat di-pageable.