Função GetConsoleDisplayMode
Importante
Este documento descreve a funcionalidade da plataforma de console que não faz mais parte do nosso roteiro do ecossistema. Não recomendamos o uso desse conteúdo em novos produtos, mas continuaremos a oferecer suporte aos usos existentes por tempo indeterminado. Nossa solução moderna preferida se concentra em sequências de terminais virtuais para máxima compatibilidade em cenários de multiplataforma. Você pode encontrar mais informações sobre essa decisão de design em nosso documento Console clássico versus terminal virtual.
Recupera o modo de exibição do console atual.
Sintaxe
BOOL WINAPI GetConsoleDisplayMode(
_Out_ LPDWORD lpModeFlags
);
Parâmetros
lpModeFlags [out]
O modo de exibição do console. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
| CONSOLE_FULLSCREEN 1 | Console de tela inteira. O console entra nesse modo quando a janela é maximizada. Neste ponto, a transição para o modo de tela inteira ainda pode falhar. |
| CONSOLE_FULLSCREEN_HARDWARE 2 | Console de tela inteira em comunicação direta com o hardware de vídeo. Esse modo é definido depois que o console estiver no modo CONSOLE_FULLSCREEN para indicar que a transição para o modo de tela inteira foi concluída. |
Observação
A transição para um modo de hardware de vídeo 100% tela inteira foi removida no Windows Vista com a reestruturação da plataforma da pilha de gráficos para WDDM. Em versões posteriores do Windows, o estado máximo resultante é CONSOLE_FULLSCREEN que representa uma janela sem moldura que é exibida em tela inteira, mas não está no controle exclusivo do hardware.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Para compilar aplicativos que usam essa função, defina _WIN32_WINNT como 0x0500 ou posterior. Para obter mais informações, consulte Usar os cabeçalhos do Windows.
Dica
Essa API não é recomendada e não tem um terminal virtual equivalente. Essa decisão alinha intencionalmente a plataforma Windows com outros sistemas operacionais nos quais o usuário tem controle total sobre essa opção de apresentação. A comunicação remota de aplicativos por meio de utilitários multiplataforma e transportes como SSH pode não funcionar como esperado se essa API é usada.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | ConsoleApi3.h (via WinCon.h, inclui o Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |