PVIDEO_HW_RESET_HW função de retorno de chamada (video.h)
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 de 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.
Valor de retorno
HwVidResetHw deverá retornar TRUE se redefinir completamente o adaptador para o modo de caractere fornecido. 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 após HwVidResetHw retornar o controle.
Observações
Um driver de miniporto de vídeo deve ter uma função HwVidResetHw se o adaptador não puder ser redefinido para um estado totalmente inicializado sem uma inicialização dura 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 é limpar as linhas de interrupção do adaptador quando o adaptador for desligado, evitando assim um dilúvio de interrupções na próxima vez que o sistema for inicializado.
O HAL chama 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 miniporto deve fornecer essa função, exceto para drivers de adaptadores que são redefinidos para um modo de caractere padrão VGA ao receber um comando INT10, tipo MODE3.
HwVidResetHw redefine o adaptador para o modo de caractere, de acordo com os valores de Colunas e linhas de 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 nos registros do 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. Uma função de HwVidStartIO de do driver de miniporto é chamada com oIOCTL_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 elementos gráficos, não a função HwVidResetHw do driver de miniport.
HwVidResetHw não deve ficar paginável.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |