Función GetConsoleDisplayMode
Importante
En este documento se describe la funcionalidad de la plataforma de consola que ya no forma parte de nuestra hoja de ruta del ecosistema. No se recomienda usar este contenido en nuevos productos, pero seguiremos admitiendo los usos existentes para un futuro indefinido. Nuestra solución moderna preferida se centra en secuencias de terminal virtual para lograr la máxima compatibilidad en escenarios multiplataforma. Puede encontrar más información sobre esta decisión de diseño en nuestro documento de la consola clásica frente al terminal virtual.
Recupera el modo de presentación de la consola actual.
Sintaxis
BOOL WINAPI GetConsoleDisplayMode(
_Out_ LPDWORD lpModeFlags
);
Parámetros
lpModeFlags [out]
Modo de visualización de la consola. Este parámetro puede ser uno o más de los siguientes valores.
| Valor | Significado |
|---|---|
| CONSOLE_FULLSCREEN_MODE 1 | Consola de pantalla completa. La consola se encuentra en este modo tan pronto como se maximiza la ventana. En este momento, la transición al modo de pantalla completa todavía puede producir un error. |
| CONSOLE_FULLSCREEN_HARDWARE 2 | Consola de pantalla completa que se comunica directamente con el hardware de vídeo. Este modo se establece después de que la consola esté en modo CONSOLE_FULLSCREEN para indicar que se ha completado la transición al modo de pantalla completa. |
Nota:
La transición a un modo de hardware de vídeo de pantalla completa al 100 % se quitó en Windows Vista con la expansión de la pila de gráficos a WDDM. En versiones posteriores de Windows, el estado máximo resultante es CONSOLE_FULLSCREEN, que representa una ventana sin marco que aparece en pantalla completa, pero no está en control exclusivo del hardware.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, consulte Uso de los encabezados de Windows.
Sugerencia
Esta API no se recomienda y no tiene un equivalente de terminal virtual. Esta decisión alinea intencionadamente la plataforma Windows con otros sistemas operativos en los que se concede al usuario control total sobre esta opción de presentación. Es posible que las aplicaciones que se comuniquen de forma remota a través de utilidades y transportes multiplataforma como SSH no funcionen como se espera si se utiliza esta API.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | ConsoleApi3.h (a través de WinCon.h, incluido Windows.h) |
| Biblioteca | Kernel32.lib |
| Archivo DLL | Kernel32.dll |