PVIDEO_HW_RESET_HW funzione di callback (video.h)

Articolo
08/07/2023

HwVidResetHw reimposta la modalità carattere dell'adattatore.

Sintassi

PVIDEO_HW_RESET_HW PvideoHwResetHw;

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

Parametri

HwDeviceExtension

Puntatore all'area di archiviazione per scheda del driver miniport. Per altre informazioni, vedere Estensioni del dispositivo.

Columns

Specifica il numero di colonne della modalità da configurare.

Rows

Specifica il numero di righe della modalità da configurare.

Valore restituito

HwVidResetHw deve restituire TRUE se reimposta completamente l'adattatore sulla modalità carattere specificata. In caso contrario, deve restituire FALSE per indicare che l'HAL deve eseguire l'equivalente di una chiamata BIOS di tipo INT10, MODE3 dopo la restituzione del controllo HwVidResetHw .

Commenti

Un driver miniport video deve avere una funzione HwVidResetHw se la relativa scheda non può essere reimpostata su uno stato completamente inizializzato senza un hard boot del computer. Ad esempio, se il codice di inizializzazione ROM dell'adattatore non può reimpostare lo stato dell'adattatore in modalità di avvio, il driver miniport deve avere una funzione HwVidResetHw . Un altro motivo per cui il driver miniport deve implementare questa funzione consiste nel pulire le linee di interruzione dell'adattatore quando l'adattatore è spento, evitando così un diluvio di interruzioni alla successiva avvio del sistema.

L'HAL chiama HwVidResetHw se il sistema sta per arrestarsi in modo anomalo, in modo che l'HAL possa visualizzare informazioni sullo schermo mentre il sistema è in fase di arresto. Questa chiamata può verificarsi in qualsiasi IRQL e il driver deve essere pronto per gestirla in qualsiasi momento. L'HAL chiama anche HwVidResetHw subito prima del riavvio del computer quando si verifica un soft boot.

La maggior parte dei driver miniport deve fornire questa funzione, ad eccezione dei driver di adattatori che vengono reimpostati su una modalità carattere standard VGA alla ricezione di un comando DIT10, MODE3.Most miniport drivers must provide this function, except for drivers of adapters that are reset to a VGA standard character mode on receipt of an INT10, MODE3-type command.

HwVidResetHw reimposta la modalità carattere dell'adattatore in base ai valori Columns e Rows specificati. Tuttavia, poiché il sistema sta arrestando, HwVidResetHw non può chiamare il BIOS o il codice impaginabile. HwVidResetHw deve chiamare solo le funzioni VideoPortRead/WritePortXxx e/o VideoPortRead/WriteRegisterXxx . Vedere Funzioni esportate dal driver della porta video.

Se HwVidResetHw non può modificare la modalità dell'adattatore semplicemente programmando i registri dell'adattatore, è possibile configurare i valori appropriati nei registri dell'adapter e restituire FALSE. In questo modo l'HAL esegue un'operazione di tipo INT10 estesa per reimpostare la modalità carattere della scheda video.

HwVidResetHw non deve chiamare VideoPortInt10. La funzione HwVidStartIO di un driver miniport viene chiamata con la IOCTL_VIDEO_RESET_DEVICE VRP per reimpostare l'adattatore ogni volta che il programma Display viene usato per testare o modificare la modalità di visualizzazione grafica, non la funzione HwVidResetHw del driver miniport.

HwVidResetHw non deve essere reso impaginabile.