video.h () PVIDEO_HW_RESET_HW 回呼函式

發行項
02/26/2024

HwVidResetHw 會將配接器重設為字元模式。

語法

PVIDEO_HW_RESET_HW PvideoHwResetHw;

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

參數

HwDeviceExtension

迷你埠驅動程式每個適配卡儲存區域的指標。如需詳細資訊，請參閱裝置延伸模組。

Columns

指定要設定之模式的數據行數目。

Rows

指定要設定之模式的數據列數目。

傳回值

如果 HwVidResetHw 完全將配接器重設為指定的字元模式，則應該傳回 TRUE 。否則，它應該傳回 FALSE ，表示 HAL 應該在 HwVidResetHw 傳回控件之後執行 INT10、MODE3 類型的 BIOS 呼叫。

備註

如果視訊迷你埠驅動程式的配接器無法重設為完全初始化狀態，則視訊迷你埠驅動程序必須具有 HwVidResetHw 函式，而不需要機器的硬式開機。例如，如果適配卡的 ROM 初始化程式代碼無法將適配卡狀態重設為開機模式，迷你埠驅動程式必須具有 HwVidResetHw 函式。迷你埠驅動程式必須實作此函式的另一個原因是，在適配卡關閉電源時清除適配卡的插斷線，以避免下次系統開機時中斷。

如果系統即將當機，HAL 會呼叫 HwVidResetHw ，讓 HAL 可以在關閉系統時在螢幕上顯示資訊。此呼叫可以在任何 IRQL 發生，而且驅動程式必須隨時準備好處理它。當發生軟開機時，HAL 也會在電腦重新啟動之前呼叫 HwVidResetHw 。

除了在收到 INT10、MODE3 類型命令時重設為 VGA 標準字元模式的適配卡驅動程式，大部分迷你埠驅動程式都必須提供此函式。

HwVidResetHw 會根據指定的數據行和數據列值，將配接器重設為字元模式。不過，因為系統正在關閉， 所以 HwVidResetHw 無法呼叫 BIOS 或任何可分頁的程序代碼。 HwVidResetHw 應該只呼叫 VideoPortRead/WritePortXxx 和/或 VideoPortRead/WriteRegisterXxx 函式。 (請參閱影片埠驅動程序導出的函式.)

如果 HwVidResetHw 只要程式設計配接器緩存器，便無法變更適配卡模式，它可以在適配卡緩存器中設定適當的值，並傳回 FALSE。這會導致 HAL 執行擴充 INT10 類型作業，以將視訊適配卡重設為字元模式。

HwVidResetHw 不得呼叫 VideoPortInt10。只要使用顯示程式來測試或變更圖形顯示模式，而不是迷你埠驅動程式的 HwVidResetHw 函式，就會使用 IOCTL_VIDEO_RESET_DEVICE VRP 呼叫迷你埠驅動程式的 HwVidStartIO 函式來重設適配卡。

HwVidResetHw 不得設為可分頁。