PVIDEO_HW_RESET_HW função de retorno de chamada (video.h)

Artigo
08/07/2023

HwVidResetHw redefine o adaptador para o modo de caractere.

Sintaxe

PVIDEO_HW_RESET_HW PvideoHwResetHw;

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

Parâmetros

HwDeviceExtension

Ponteiro para a área de armazenamento por adaptador do driver de miniport. Para obter mais informações, consulte Extensões de dispositivo.

Columns

Especifica o número de colunas do modo a ser configurado.

Rows

Especifica o número de linhas do modo a ser configurado.

Retornar valor

HwVidResetHw deverá retornar TRUE se ele redefinir completamente o adaptador para o modo de caractere determinado. Caso contrário, ele deverá retornar FALSE para indicar que o HAL deve executar o equivalente a uma chamada BIOS do tipo INT10 e MODE3 depois que HwVidResetHw retornar o controle.

Comentários

Um driver de miniporto de vídeo deverá ter uma função HwVidResetHw se o adaptador não puder ser redefinido para um estado totalmente inicializado sem uma inicialização forçada do computador. Por exemplo, se o código de inicialização rom do adaptador não puder redefinir o estado do adaptador para um modo de inicialização, o driver de miniporto deverá ter uma função HwVidResetHw . Outro motivo pelo qual o driver de miniporto deve implementar essa função é limpo as linhas de interrupção do adaptador quando o adaptador é desligado, evitando assim um dilúvio de interrupções na próxima vez que o sistema for inicializado.

O HAL chamará HwVidResetHw se o sistema estiver prestes a falhar, para que o HAL possa exibir informações na tela enquanto o sistema está sendo desligado. Essa chamada pode ocorrer em qualquer IRQL e o driver deve estar pronto para lidar com ela a qualquer momento. O HAL também chama HwVidResetHw pouco antes de o computador ser reinicializado quando ocorre uma inicialização reversível.

A maioria dos drivers de miniporta deve fornecer essa função, exceto para drivers de adaptadores que são redefinidos para um modo de caractere padrão VGA no recebimento de um comando INT10, tipo MODE3.

HwVidResetHw redefine o adaptador para o modo de caractere, de acordo com os valores de Colunas e Linhas fornecidos. No entanto, como o sistema está sendo desligado, hwVidResetHw não pode chamar o BIOS ou qualquer código paginável. HwVidResetHw deve chamar apenas as funções VideoPortRead/WritePortXxx e/ou VideoPortRead/WriteRegisterXxx . (Consulte Funções exportadas pelo driver de porta de vídeo.)

Se HwVidResetHw não puder alterar o modo do adaptador simplesmente programando os registros do adaptador, ele poderá configurar os valores apropriados em registros de adaptador e retornar FALSE. Isso faz com que o HAL execute uma operação estendida do tipo INT10 para redefinir o adaptador de vídeo para o modo de caractere.

HwVidResetHw não deve chamar VideoPortInt10. A função HwVidStartIO de um driver de miniport é chamada com o IOCTL_VIDEO_RESET_DEVICE VRP para redefinir o adaptador sempre que o programa Display for usado para testar ou alterar o modo de exibição de gráficos, não a função HwVidResetHw do driver de miniport.

HwVidResetHw não deve ser tornado paginável.