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 |
|---|---|
|
La fonction a réussi. |
|
La combinaison de paramètres et d’indicateurs spécifiés n’est pas valide. |
|
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. |
|
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. |
|
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) |