Fonction GetConsoleScreenBufferInfoEx
Récupère des informations étendues sur la mémoire tampon d’écran de la console spécifiée.
Syntaxe
BOOL WINAPI GetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_Out_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Paramètres
hConsoleOutput [entrée]
Un descripteur vers la mémoire tampon de l’écran de la console. Le descripteur doit avoir le droit d’accès GENERIC_READ. Pour plus d’informations, consultez Sécurité de la mémoire tampon et droits d’accès d’une console.
lpConsoleScreenBufferInfoEx [sortie]
Une structure CONSOLE_SCREEN_BUFFER_INFOEX qui reçoit les informations de mémoire tampon de l’écran de la console.
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
Le rectangle renvoyé dans le membre srWindow de la structure CONSOLE_SCREEN_BUFFER_INFOEX peut être modifié, puis transmis à la fonction SetConsoleWindowInfo pour faire défiler la mémoire tampon de l'écran de la console dans la fenêtre, pour modifier la taille de la fenêtre, ou les deux.
Toutes les coordonnées renvoyées dans la structure CONSOLE_SCREEN_BUFFER_INFOEX sont des coordonnées de cellules de caractères, où l'origine (0, 0) se trouve dans le coin supérieur gauche de la mémoire tampon de l'écran de la console.
Conseil
Cette API n'a pas d'équivalent au niveau des terminaux virtuels. Son utilisation peut toujours être nécessaire pour les applications qui tentent de dessiner des colonnes, des grilles ou de remplir l’affichage pour récupérer la taille de la fenêtre. Cet état de fenêtre est géré par le ATS/PTY/Pseudoconsole en dehors du flux normal et est généralement considéré comme un privilège utilisateur non ajustable par l'application cliente. Les mises à jour peuvent être reçues sur ReadConsoleInput.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | ConsoleApi2.h (via WinCon.h, include Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |