GetConsoleDisplayMode-Funktion
Wichtig
In diesem Dokument werden Konsolenplattformfunktionen beschrieben, die nicht mehr Teil unserer Ökosystem-Roadmap sind. Wir empfehlen nicht, diesen Inhalt in neuen Produkten zu verwenden, aber wir werden weiterhin vorhandene Nutzungen für die unbegrenzte Zukunft unterstützen. Unsere bevorzugte moderne Lösung konzentriert sich auf virtuelle Terminalsequenzen für maximale Kompatibilität in plattformübergreifenden Szenarien. Weitere Informationen zu dieser Designentscheidung finden Sie in unserem klassischen Konsolendokument im Vergleich zum virtuellen Terminal .
Ruft den Anzeigemodus der aktuellen Konsole ab.
Syntax
BOOL WINAPI GetConsoleDisplayMode(
_Out_ LPDWORD lpModeFlags
);
Parameter
lpModeFlags [out]
Der Anzeigemodus der Konsole. Dieser Parameter kann einen der folgenden Werte annehmen.
| Wert | Bedeutung |
|---|---|
| CONSOLE_FULLSCREEN 1 | Vollbildkonsole. Die Konsole befindet sich in diesem Modus, sobald das Fenster maximiert ist. An diesem Punkt kann der Übergang zum Vollbildmodus weiterhin fehlschlagen. |
| CONSOLE_FULLSCREEN_HARDWARE 2 | Die Vollbildkonsole kommuniziert direkt mit der Videohardware. Dieser Modus wird festgelegt, nachdem sich die Konsole im modus CONSOLE_FULLSCREEN befindet, um anzugeben, dass der Übergang zum Vollbildmodus abgeschlossen ist. |
Hinweis
Der Übergang zu einem 100%igen Vollbild-Videohardwaremodus wurde in Windows Vista mit der Umformung des Grafikstapels auf WDDM entfernt. In späteren Versionen von Windows wird der maximal resultierende Zustand CONSOLE_FULLSCREEN , der ein frameloses Fenster darstellt, das im Vollbildmodus angezeigt wird, aber nicht ausschließlich die Kontrolle über die Hardware hat.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0500 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Tipp
Diese API wird nicht empfohlen und verfügt nicht über eine virtuelle Terminalentsprechung. Diese Entscheidung richtet die Windows-Plattform absichtlich mit anderen Betriebssystemen aus, auf denen dem Benutzer die volle Kontrolle über diese Präsentationsoption gewährt wird. Anwendungen, die über plattformübergreifende Dienstprogramme und Transporte wie SSH remoten, funktionieren möglicherweise nicht wie erwartet, wenn Sie diese API verwenden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Header | ConsoleApi3.h (über WinCon.h, Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |