Partager via


Fonction GetConsoleDisplayMode

Important

Ce document décrit les fonctionnalités de la plateforme de la console qui ne font plus partie de la feuille de route de notre écosystème. Nous vous déconseillons d’utiliser ce contenu dans de nouveaux produits, mais nous continuerons à prendre en charge des utilisations existantes pour l’avenir indéterminé. Notre solution moderne préférée se concentre sur les séquences de terminaux virtuels pour une compatibilité maximale dans les scénarios multiplateformes. Vous trouverez plus d’informations sur cette décision de conception dans notre document sur les consoles classiques et les terminaux virtuels.

Récupère le mode d’affichage de la console actuelle.

Syntaxe

BOOL WINAPI GetConsoleDisplayMode(
  _Out_ LPDWORD lpModeFlags
);

Paramètres

lpModeFlags [sortie]
Mode d’affichage de la console. Ce paramètre peut prendre l’une ou plusieurs des valeurs suivantes.

Valeur Signification
CONSOLE_FULLSCREEN 1 Console plein écran. La console est dans ce mode dès que la fenêtre est agrandie. À ce stade, la transition vers le mode plein écran peut toujours échouer.
CONSOLE_FULLSCREEN_HARDWARE 2 Console plein écran communiquant directement avec le matériel vidéo. Ce mode est activé une fois que la console est en mode CONSOLE_FULLSCREEN pour indiquer que la transition vers le mode plein écran est terminée.

Remarque

La transition vers un mode matériel vidéo 100 % plein écran a été supprimée dans Windows Vista avec la reformation de la pile graphique vers WDDM. Sur les versions ultérieures de Windows, l'état maximum résultant est CONSOLE_FULLSCREEN, ce qui représente une fenêtre sans cadre qui apparaît en plein écran mais qui n'a pas le contrôle exclusif du matériel.

Valeur renvoyée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT sur 0x0500 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Conseil

Cette API n’est pas recommandée et n’a pas d’équivalent de terminal virtuel. Cette décision aligne intentionnellement la plateforme Windows avec d’autres systèmes d’exploitation où l’utilisateur dispose d’un contrôle total sur cette option de présentation. La communication à distance des applications via des utilitaires multiplateformes et des transports comme SSH peut ne pas fonctionner comme prévu si vous utilisez cette API.

Spécifications

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête ConsoleApi3.h (via WinCon.h, include Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

Fonctions de console

Modes de la console

SetConsoleDisplayMode