PVIDEO_HW_RESET_HW Rückruffunktion (video.h)

Artikel
02/26/2024

HwVidResetHw setzt den Adapter auf den Zeichenmodus zurück.

Syntax

PVIDEO_HW_RESET_HW PvideoHwResetHw;

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

Parameter

HwDeviceExtension

Zeiger auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.

Columns

Gibt die Anzahl der Spalten des einzurichtenden Modus an.

Rows

Gibt die Anzahl der Zeilen des einzurichtenden Modus an.

Rückgabewert

HwVidResetHw sollte TRUE zurückgeben, wenn der Adapter vollständig auf den angegebenen Zeichenmodus zurückgesetzt wird. Andernfalls sollte false zurückgegeben werden, um anzugeben, dass die HAL das Äquivalent eines BIOS-Aufrufs vom TYP INT10, MODE3 ausführen soll, nachdem HwVidResetHw das Steuerelement zurückgegeben hat.

Hinweise

Ein Video-Miniporttreiber muss über eine HwVidResetHw-Funktion verfügen, wenn sein Adapter nicht ohne einen Hardstart des Computers auf einen vollständig initialisierten Zustand zurückgesetzt werden kann. Wenn der ROM-Initialisierungscode des Adapters beispielsweise nicht den Adapterzustand auf einen Startmodus zurücksetzen kann, muss der Miniporttreiber über eine HwVidResetHw-Funktion verfügen. Ein weiterer Grund, warum der Miniporttreiber diese Funktion implementieren muss, besteht darin, die Interruptleitungen des Adapters beim Herunterfahren des Adapters zu sauber, um beim nächsten Start des Systems eine Flut von Interrupts zu vermeiden.

Die HAL ruft HwVidResetHw auf, wenn das System abstürzen wird, sodass die HAL Informationen auf dem Bildschirm anzeigen kann, während das System heruntergefahren wird. Dieser Aufruf kann bei jedem IRQL erfolgen, und der Treiber muss jederzeit bereit sein, ihn zu verarbeiten. Die HAL ruft auch HwVidResetHw auf, kurz bevor der Computer neu gestartet wird, wenn ein Softstart auftritt.

Die meisten Miniporttreiber müssen diese Funktion bereitstellen, mit Ausnahme von Treibern von Adaptern, die beim Empfang eines INT10-Befehls vom Typ MODE3 auf einen VGA-Standardzeichenmodus zurückgesetzt werden.

HwVidResetHw setzt den Adapter gemäß den angegebenen Spalten - und Zeilenwerten auf den Zeichenmodus zurück. Da das System jedoch heruntergefahren wird, kann HwVidResetHw weder das BIOS noch den auslagerungsfähigen Code aufrufen. HwVidResetHw sollte nur die Xxx-Funktionen VideoPortRead/WritePortPort und/oder VideoPortRead/WriteRegisteraufrufen. (Siehe Vom Videoporttreiber exportierte Funktionen.)

Wenn HwVidResetHw den Modus des Adapters nicht durch einfache Programmierung der Adapterregister ändern kann, kann es die entsprechenden Werte in Adapterregistern einrichten und FALSE zurückgeben. Dies bewirkt, dass die HAL einen erweiterten INT10-Typ-Vorgang ausführt, um die Grafikkarte in den Zeichenmodus zurückzusetzen.

HwVidResetHw darf VideoPortInt10 nicht aufrufen. Die HwVidStartIO-Funktion eines Miniporttreibers wird mit dem IOCTL_VIDEO_RESET_DEVICE VRP aufgerufen, um den Adapter zurückzusetzen, wenn das Display-Programm verwendet wird, um den Grafikanzeigemodus zu testen oder zu ändern, nicht die HwVidResetHw-Funktion des Miniporttreibers.

HwVidResetHw darf nicht seitenfähig gemacht werden.