Funzione GetConsoleScreenBufferInfoEx

  • Articolo

Recupera informazioni estese sul buffer dello schermo della console specificato.

Sintassi

BOOL WINAPI GetConsoleScreenBufferInfoEx(
  _In_  HANDLE                        hConsoleOutput,
  _Out_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);

Parametri

hConsoleOutput [in]
Handle per il buffer dello schermo della console. L'handle deve avere il diritto di accesso GENERIC_READ . Per altre informazioni, vedere Sicurezza dei buffer della console e diritti di accesso.

lpConsoleScreenBufferInfoEx [out]
Struttura CONSOLE_SCRedizione EnterpriseN_BUFFER_INFOEX che riceve le informazioni richieste sul buffer dello schermo della console.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni:

Il rettangolo restituito nel membro srWindow della struttura CONSOLE_SCRedizione EnterpriseN_BUFFER_INFOEX può essere modificato e quindi passato alla funzione SetConsoleWindowInfo per scorrere il buffer dello schermo della console nella finestra, per modificare le dimensioni della finestra o entrambi.

Tutte le coordinate restituite nella struttura CONSOLE_SCRedizione EnterpriseN_BUFFER_INFOEX si trovano nelle coordinate delle celle di caratteri, dove l'origine (0, 0) si trova nell'angolo superiore sinistro del buffer dello schermo della console.

Suggerimento

Questa API non ha un terminale virtuale equivalente. L'uso può comunque essere necessario per le applicazioni che tentano di disegnare colonne, griglie o riempire la visualizzazione per recuperare le dimensioni della finestra. Questo stato della finestra viene gestito dalla TTY/PTY/Pseudoconsole al di fuori del flusso normale ed è generalmente considerato un privilegio utente non modificabile dall'applicazione client. Aggiornamenti possono essere ricevuti ReadConsoleInput.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione ConsoleApi2.h (tramite WinCon.h, includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedi anche

Funzioni della console

CONSOLE_SCRedizione EnterpriseN_BUFFER_INFOEX

SetConsoleScreenBufferInfoEx