DisplayConfigGetDeviceInfo, fonction (winuser.h)

Article
03/06/2024

La fonction DisplayConfigGetDeviceInfo récupère les informations de configuration d’affichage sur l’appareil.

Syntaxe

LONG DisplayConfigGetDeviceInfo(
  [in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);

Paramètres

[in, out] requestPacket

Pointeur vers une structure DISPLAYCONFIG_DEVICE_INFO_HEADER . Cette structure contient des informations sur la requête, qui inclut le type de paquet dans le membre de type . Le type et la taille des données supplémentaires retournées par DisplayConfigGetDeviceInfo après la structure d’en-tête dépendent du type de paquet.

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 sur lequel un pilote WDDM est 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 à distance.
ERROR_INSUFFICIENT_BUFFER	La taille du paquet que l’appelant passe n’est pas suffisamment grande pour les informations que l’appelant demande.
ERROR_GEN_FAILURE	Une erreur non spécifiée s'est produite.

Remarques

Utilisez la fonction DisplayConfigGetDeviceInfo pour obtenir des informations supplémentaires sur une source ou une cible pour un adaptateur, telles que le nom d’affichage, le mode d’affichage par défaut et le nom de l’appareil source.

L’appelant peut appeler DisplayConfigGetDeviceInfo pour obtenir des noms plus conviviaux à afficher dans l’interface utilisateur. L’appelant peut obtenir des noms pour l’adaptateur, la source et la cible. L’appelant peut également appeler DisplayConfigGetDeviceInfo pour obtenir la meilleure résolution du périphérique d’affichage connecté.

Exemples

Consultez QueryDisplayConfig pour obtenir un exemple de DisplayConfigGetDeviceInfo.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et 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)