GetDisplayConfigBufferSizes, fonction (winuser.h)

La fonction GetDisplayConfigBufferSizes récupère la taille des mémoires tampons requises pour appeler la fonction QueryDisplayConfig .

Syntaxe

LONG GetDisplayConfigBufferSizes(
  [in]  UINT32 flags,
  [out] UINT32 *numPathArrayElements,
  [out] UINT32 *numModeInfoArrayElements
);

Paramètres

[in] flags

Type d’informations à récupérer. La valeur du paramètre Flags doit être l’une des valeurs suivantes.

QDC_ALL_PATHS

L’appelant demande que les tailles de table contiennent toutes les combinaisons de chemins possibles.

QDC_ONLY_ACTIVE_PATHS

L’appelant demande que les tailles de table contiennent uniquement les chemins d’accès actifs.

QDC_DATABASE_CURRENT

L’appelant demande aux tailles de table de contenir les chemins d’accès actifs tels que définis dans la base de données de persistance pour les moniteurs actuellement connectés.

[out] numPathArrayElements

Pointeur vers une variable qui reçoit le nombre d’éléments dans la table d’informations sur le chemin d’accès. La valeur du paramètre pNumPathArrayElements est ensuite utilisée par un appel suivant à la fonction QueryDisplayConfig . Ce paramètre ne peut pas avoir la valeur NULL.

[out] numModeInfoArrayElements

Pointeur vers une variable qui reçoit le nombre d’éléments dans la table d’informations de mode. La valeur du paramètre pNumModeInfoArrayElements est ensuite utilisée par un appel suivant à la fonction QueryDisplayConfig . Ce paramètre ne peut pas avoir la valeur NULL.

Valeur retournée

La fonction retourne l’un des codes de retour suivants.

Code de retour	Description
ERROR_SUCCESS	La fonction a réussi.
ERROR_INVALID_PARAMETER	La combinaison de paramètres et d’indicateurs spécifiés n’est pas valide.
ERROR_NOT_SUPPORTED	Le système n’exécute pas de pilote graphique qui a été écrit selon le modèle WDDM (Windows Display Driver Model). La fonction est uniquement prise en charge sur un système avec un pilote WDDM en cours d’exécution.
ERROR_ACCESS_DENIED	L’appelant n’a pas accès à la session de console. Cette erreur se produit si le processus appelant n’a pas accès au bureau actuel ou s’exécute sur une session distante.
ERROR_GEN_FAILURE	Une erreur non spécifiée s'est produite.

Remarques

Compte tenu de la configuration actuelle du chemin d’affichage et des indicateurs demandés, GetDisplayConfigBufferSizes retourne la taille des tables de chemin d’accès et de mode requises pour stocker les informations. GetDisplayConfigBufferSizes peut retourner des valeurs légèrement supérieures à ce qui est réellement requis, car il détermine que tous les chemins source et cible sont valides ; tandis que le conducteur peut placer certaines restrictions sur les combinaisons possibles.

Comme GetDisplayConfigBufferSizes peut uniquement déterminer la taille de tableau requise à ce moment dans le temps, il est possible qu’entre les appels à GetDisplayConfigBufferSizes et QueryDisplayConfig , la configuration système ait changé et les tailles de tableau fournies ne soient plus suffisantes pour stocker les nouvelles données de chemin d’accès.

Si un appelant est conscient qu’il doit activer des sources et des cibles supplémentaires, l’appelant peut allouer un tableau d’informations en mode plus grand que celui renvoyé par GetDisplayConfigBufferSizes afin qu’il dispose de l’espace nécessaire pour ajouter les modes source et cible supplémentaires après l’appel de QueryDisplayConfig et avant d’appeler SetDisplayConfig.

Exemples

Consultez QueryDisplayConfig pour obtenir un exemple de GetDisplayConfigBufferSizes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib ; OneCoreUAP.lib sur Windows 10
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

QueryDisplayConfig

SetDisplayConfig