Función GetDisplayConfigBufferSizes (winuser.h)
La función GetDisplayConfigBufferSizes recupera el tamaño de los búferes necesarios para llamar a la función QueryDisplayConfig .
Sintaxis
LONG GetDisplayConfigBufferSizes(
[in] UINT32 flags,
[out] UINT32 *numPathArrayElements,
[out] UINT32 *numModeInfoArrayElements
);
Parámetros
[in] flags
Tipo de información que se va a recuperar. El valor del parámetro Flags debe ser uno de los valores siguientes.
QDC_ALL_PATHS
El autor de la llamada solicita a los tamaños de tabla que contengan todas las combinaciones de ruta de acceso posibles.
QDC_ONLY_ACTIVE_PATHS
El autor de la llamada solicita a los tamaños de tabla que contengan solo rutas de acceso activas.
QDC_DATABASE_CURRENT
El autor de la llamada solicita a los tamaños de tabla que contengan las rutas de acceso activas, tal como se define en la base de datos de persistencia para los monitores conectados actualmente.
[out] numPathArrayElements
Puntero a una variable que recibe el número de elementos de la tabla de información de ruta de acceso. A continuación, se usa el valor del parámetro pNumPathArrayElements mediante una llamada posterior a la función QueryDisplayConfig . Este parámetro no puede ser NULL.
[out] numModeInfoArrayElements
Puntero a una variable que recibe el número de elementos de la tabla de información en modo. A continuación, se usa el valor del parámetro pNumModeInfoArrayElements mediante una llamada posterior a la función QueryDisplayConfig . Este parámetro no puede ser NULL.
Valor devuelto
La función devuelve uno de los siguientes códigos de retorno.
| Código devuelto | Descripción |
|---|---|
|
La función se ha realizado correctamente. |
|
La combinación de parámetros y marcas que se especifican no es válida. |
|
El sistema no ejecuta un controlador de gráficos escrito según el modelo de controlador de pantalla de Windows (WDDM). La función solo se admite en un sistema con un controlador WDDM en ejecución. |
|
El llamador no tiene acceso a la sesión de consola. Este error se produce si el proceso de llamada no tiene acceso al escritorio actual o se ejecuta en una sesión remota. |
|
Se ha producido un error no especificado. |
Comentarios
Dada la configuración actual de la ruta de acceso de presentación y las marcas solicitadas, GetDisplayConfigBufferSizes devuelve el tamaño de las tablas de ruta de acceso y modo necesarias para almacenar la información. GetDisplayConfigBufferSizes puede devolver valores ligeramente mayores de los que realmente son necesarios porque determina que todas las rutas de acceso de origen y destino son válidas; mientras que el controlador podría aplicar algunas restricciones a las posibles combinaciones.
Como GetDisplayConfigBufferSizes solo puede determinar el tamaño de matriz necesario de ese momento en el tiempo, es posible que entre las llamadas a GetDisplayConfigBufferSizes y QueryDisplayConfig la configuración del sistema haya cambiado y los tamaños de matriz proporcionados ya no sean suficientes para almacenar los nuevos datos de ruta de acceso.
Si un llamador es consciente de que debe habilitar orígenes y destinos adicionales, el autor de la llamada puede asignar una matriz de información de modo más grande que se devuelve de GetDisplayConfigBufferSizes para que tenga el espacio para agregar los modos de origen y destino adicionales después de llamar a QueryDisplayConfig y antes de llamar a SetDisplayConfig.
Ejemplos
Consulte QueryDisplayConfig para obtener un ejemplo de GetDisplayConfigBufferSizes.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winuser.h (incluir Windows.h) |
| Library | User32.lib; OneCoreUAP.lib en Windows 10 |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introducido en Windows 10, versión 10.0.14393) |