Bagikan melalui


Fungsi GetConsoleDisplayMode

Penting

Dokumen ini menjelaskan fungsionalitas platform konsol yang tidak lagi menjadi bagian dari peta jalan ekosistem kami. Kami tidak menyarankan penggunaan konten ini dalam produk baru, tetapi kami akan terus mendukung penggunaan yang ada untuk masa depan yang tidak terbatas. Solusi modern pilihan kami berfokus pada urutan terminal virtual untuk kompatibilitas maksimum dalam skenario lintas platform. Anda dapat menemukan informasi selengkapnya tentang keputusan desain ini di konsol klasik vs. dokumen terminal virtual kami.

Mengambil mode tampilan konsol saat ini.

Sintaks

BOOL WINAPI GetConsoleDisplayMode(
  _Out_ LPDWORD lpModeFlags
);

Parameter

lpModeFlags [out]
Mode tampilan konsol. Parameter ini bisa berupa satu atau beberapa nilai berikut.

Value Makna
CONSOLE_FULLSCREEN 1 Konsol layar penuh. Konsol dalam mode ini segera setelah jendela dimaksimalkan. Pada titik ini, transisi ke mode layar penuh masih dapat gagal.
CONSOLE_FULLSCREEN_HARDWARE 2 Konsol layar penuh berkomunikasi langsung dengan perangkat keras video. Mode ini diatur setelah konsol dalam mode CONSOLE_FULLSCREEN untuk menunjukkan bahwa transisi ke mode layar penuh telah selesai.

Catatan

Transisi ke mode perangkat keras video layar penuh 100% dihapus di Windows Vista dengan replatforming tumpukan grafis ke WDDM. Pada versi Windows yang lebih baru, status maksimum yang dihasilkan adalah CONSOLE_FULLSCREEN mewakili jendela tanpa bingkai yang muncul layar penuh tetapi tidak berada dalam kontrol eksklusif perangkat keras.

Nilai hasil

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0500 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Tip

API ini tidak disarankan dan tidak memiliki terminal virtual yang setara. Keputusan ini sengaja menyelaraskan platform Windows dengan sistem operasi lain di mana pengguna diberikan kontrol penuh atas opsi presentasi ini. Aplikasi jarak jauh melalui utilitas lintas platform dan transportasi seperti SSH mungkin tidak berfungsi seperti yang diharapkan jika menggunakan API ini.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header ConsoleApi3.h (melalui WinCon.h, termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Baca juga

Fungsi Konsol

Mode Konsol

SetConsoleDisplayMode