Función GetConsoleScreenBufferInfoEx
Recupera información ampliada sobre el búfer de pantalla de consola especificado.
Sintaxis
BOOL WINAPI GetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_Out_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Parámetros
hConsoleOutput [in]
Identificador del búfer de pantalla de la consola. El identificador debe tener derecho de acceso de GENERIC_READ. Para obtener más información, consulte Seguridad y derechos de acceso del búfer de la consola.
lpConsoleScreenBufferInfoEx [out]
Estructura CONSOLE_SCREEN_BUFFER_INFOEX que recibe la información solicitada del búfer de pantalla de consola.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
El rectángulo devuelto en el miembro srWindow de la estructura CONSOLE_SCREEN_BUFFER_INFOEX se puede modificar y, a continuación, pasar a la función SetConsoleWindowInfo para desplazar el búfer de pantalla de consola en la ventana, cambiar el tamaño de la ventana o realizar ambas acciones.
Todas las coordenadas devueltas en la estructura CONSOLE_SCREEN_BUFFER_INFOEX están en coordenadas de celda de caracteres, donde el origen (0,0) se encuentra en la esquina superior izquierda del búfer de pantalla de consola.
Sugerencia
Esta API no tiene un equivalente de terminal virtual. Es posible que se siga requiriendo su uso en el caso de las aplicaciones que intentan dibujar columnas o cuadrículas, o rellenar la pantalla para recuperar el tamaño de la ventana. Este estado de ventana se administra mediante la TTY/PTY/pseudoconsola fuera del flujo normal y, generalmente, la aplicación cliente lo considera un privilegio de usuario no ajustable. Se pueden recibir novedades en ReadConsoleInput.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | ConsoleApi2.h (a través de WinCon.h, incluido Windows.h) |
| Biblioteca | Kernel32.lib |
| Archivo DLL | Kernel32.dll |