PVIDEO_HW_RESET_HWコールバック関数 (video.h)

[アーティクル]
02/29/2024

HwVidResetHw は、アダプターを文字モードにリセットします。

構文

PVIDEO_HW_RESET_HW PvideoHwResetHw;

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

パラメーター

HwDeviceExtension

ミニポートドライバーのアダプターごとの記憶域へのポインター。詳細については、「デバイス拡張機能」を参照してください。

Columns

設定するモードの列数を指定します。

Rows

設定するモードの行数を指定します。

戻り値

HwVidResetHw は、アダプターを指定された文字モードに完全にリセットする場合は TRUE を 返す必要があります。それ以外の場合は、HWVidResetHw が制御を返した後、HAL が INT10 と同等の MODE3 型 BIOS 呼び出しを実行する必要があることを示す FALSE を返す必要があります。

注釈

ビデオミニポートドライバーは、そのアダプターがマシンのハードブートなしで完全に初期化された状態にリセットできない場合 は、HwVidResetHw 関数を持っている必要があります。たとえば、アダプターの ROM 初期化コードでアダプターの状態をブートアップモードにリセットできない場合、ミニポートドライバーには HwVidResetHw 関数が必要です。ミニポートドライバーがこの関数を実装する必要があるもう 1 つの理由は、アダプターの電源が切れたときにアダプターの割り込み行をクリーンし、システムが次回起動時に割り込みを減らさないようにすることです。

システムがクラッシュしようとしている場合、HAL は HwVidResetHw を呼び出し、システムのシャットダウン中に HAL が画面上に情報を表示できるようにします。この呼び出しは任意の IRQL で行うことができます。ドライバーは、いつでもそれを処理する準備ができている必要があります。 HAL は、ソフトブートが発生したときにマシンが再起動される直前に HwVidResetHw も呼び出します。

ほとんどのミニポートドライバーは、INT10、MODE3 型コマンドの受信時に VGA 標準文字モードにリセットされるアダプターのドライバーを除き、この関数を提供する必要があります。

HwVidResetHw は、指定された Columns と Rows の値に従って、アダプターを文字モードにリセットします。ただし、システムがシャットダウンしているため、 HwVidResetHw は BIOS またはページング可能なコードを呼び出すことができません。 HwVidResetHw では、 VideoPortRead/WritePortXxx 関数または VideoPortRead/WriteRegisterXxx 関数のみを呼び出す必要があります。 ( 「ビデオポートドライバーによってエクスポートされた関数」を参照してください)。

HwVidResetHw は、アダプターレジスタをプログラミングするだけでアダプターのモードを変更できない場合は、アダプターレジスタに適切な値を設定し、FALSE を返すことができます。これにより、HAL は拡張 INT10 型の操作を実行して、ビデオアダプターを文字モードにリセットします。

HwVidResetHw はVideoPortInt10 を呼び出してはなりません。ミニポートドライバーの HwVidStartIO 関数は、ディスプレイプログラムがミニポートドライバーの HwVidResetHw 関数ではなく、グラフィックス表示モードのテストまたは変更に使用されるたびにアダプターをリセットするために、IOCTL_VIDEO_RESET_DEVICE VRP と共に呼び出されます。

HwVidResetHw をページング可能にすることはできません。