Fungsi GetConsoleScreenBufferInfoEx
Mengambil informasi yang diperluas tentang buffer layar konsol yang ditentukan.
Sintaks
BOOL WINAPI GetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_Out_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Parameter
hConsoleOutput [in]
Handel ke buffer layar konsol. Handel harus memiliki akses GENERIC_READ yang tepat. Untuk informasi selengkapnya, lihat Keamanan dan Hak Akses Buffer Konsol.
lpConsoleScreenBufferInfoEx [out]
Struktur CONSOLE_SCREEN_BUFFER_INFOEX yang menerima informasi buffer layar konsol yang diminta.
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
Persegi panjang yang dikembalikan di anggota srWindow dari struktur CONSOLE_SCREEN_BUFFER_INFOEX dapat dimodifikasi dan kemudian diteruskan ke fungsi SetConsoleWindowInfo untuk menggulir buffer layar konsol di jendela, untuk mengubah ukuran jendela, atau keduanya.
Semua koordinat yang dikembalikan dalam struktur CONSOLE_SCREEN_BUFFER_INFOEX berada dalam koordinat sel karakter, di mana asal (0, 0) berada di sudut kiri atas buffer layar konsol.
Tip
API ini tidak memiliki terminal virtual yang setara. Penggunaannya mungkin masih diperlukan untuk aplikasi yang mencoba menggambar kolom, kisi, atau mengisi tampilan untuk mengambil ukuran jendela. Status jendela ini dikelola oleh TTY/PTY/Pseudoconsole di luar aliran aliran normal dan umumnya dianggap sebagai hak istimewa pengguna yang tidak dapat disesuaikan oleh aplikasi klien. Pembaruan dapat diterima di ReadConsoleInput.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | ConsoleApi2.h (melalui WinCon.h, termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |