PVIDEO_HW_RESET_HW función de devolución de llamada (video.h)

Artículo
08/07/2023

HwVidResetHw restablece el adaptador al modo de caracteres.

Sintaxis

PVIDEO_HW_RESET_HW PvideoHwResetHw;

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

Parámetros

HwDeviceExtension

Puntero al área de almacenamiento por adaptador del controlador miniporte. Para obtener más información, consulte Extensiones de dispositivo.

Columns

Especifica el número de columnas del modo que se va a configurar.

Rows

Especifica el número de filas del modo que se va a configurar.

Valor devuelto

HwVidResetHw debe devolver TRUE si restablece completamente el adaptador al modo de carácter especificado. De lo contrario, debe devolver FALSE para indicar que HAL debe realizar el equivalente de una llamada BIOS INT10, MODE3-type después de que HwVidResetHw devuelva el control.

Comentarios

Un controlador de minipuerto de vídeo debe tener una función HwVidResetHw si su adaptador no se puede restablecer a un estado completamente inicializado sin un arranque duro de la máquina. Por ejemplo, si el código de inicialización rom del adaptador no puede restablecer el estado del adaptador a un modo de arranque, el controlador de minipuerto debe tener una función HwVidResetHw . Otra razón por la que el controlador de minipuerto debe implementar esta función es limpiar las líneas de interrupción del adaptador cuando el adaptador está apagado, evitando así una desluz de interrupciones la próxima vez que arranque el sistema.

El HAL llama a HwVidResetHw si el sistema está a punto de bloquearse, de modo que HAL pueda mostrar información en la pantalla mientras se apaga el sistema. Esta llamada puede producirse en cualquier IRQL y el controlador debe estar listo para controlarlo en cualquier momento. El HAL también llama a HwVidResetHw justo antes de reiniciar la máquina cuando se produce un arranque temporal.

La mayoría de los controladores de minipuerto deben proporcionar esta función, excepto para los controladores de adaptadores que se restablecen a un modo de caracteres estándar VGA al recibir un comando INT10, MODE3-type.

HwVidResetHw restablece el adaptador al modo de caracteres, según los valores de columnas y filas especificados . Sin embargo, dado que el sistema se está apagando, HwVidResetHw no puede llamar al BIOS ni a ningún código paginable. HwVidResetHw solo debe llamar a las funciones VideoPortRead/WritePortXxx o VideoPortRead/WriteRegisterXxx . (Vea Funciones exportadas por el controlador de puerto de vídeo).

Si HwVidResetHw no puede cambiar el modo del adaptador simplemente programando los registros del adaptador, puede configurar los valores adecuados en los registros del adaptador y devolver FALSE. Esto hace que HAL realice una operación extendida de tipo INT10 para restablecer el adaptador de vídeo al modo de caracteres.

HwVidResetHw no debe llamar a VideoPortInt10. Se llama a una función HwVidStartIO del controlador de miniporte con el VRP IOCTL_VIDEO_RESET_DEVICE para restablecer el adaptador cada vez que se usa el programa Display para probar o cambiar el modo de presentación de gráficos, no la función HwVidResetHw del controlador de miniporte.

HwVidResetHw no debe ser paginable.