Fungsi GetConsoleScreenBufferInfoEx

Artikel
10/23/2023

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

Bagikan melalui