Partager via

DisplayConfigSetDeviceInfo, fonction (winuser.h)

  • Article

La fonction DisplayConfigSetDeviceInfo définit les propriétés d’une cible.

Syntaxe

LONG DisplayConfigSetDeviceInfo(
  [in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);

Paramètres

[in] setPacket

Pointeur vers une structure DISPLAYCONFIG_DEVICE_INFO_HEADER qui contient des informations à définir pour l’appareil. Le type et la taille des données supplémentaires que DisplayConfigSetDeviceInfo utilise pour la configuration viennent après la structure d’en-tête. Ces données supplémentaires dépendent du type de paquet, tel que spécifié par le membre de type de DISPLAYCONFIG_DEVICE_INFO_HEADER. Par exemple, si l’appelant souhaite modifier la persistance de démarrage, cet appelant alloue et remplit une structure DISPLAYCONFIG_SET_TARGET_PERSISTENCE et passe un pointeur vers cette structure dans setPacket. Notez que le premier membre de la structure DISPLAYCONFIG_SET_TARGET_PERSISTENCE est le DISPLAYCONFIG_DEVICE_INFO_HEADER.

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 assez grande.
ERROR_GEN_FAILURE
 Une erreur non spécifiée s'est produite.

Remarques

DisplayConfigSetDeviceInfo ne peut actuellement être utilisé que pour démarrer et arrêter la projection de force persistante au démarrage sur une cible analogique. Pour plus d’informations sur la persistance du démarrage, consultez Cibles forcées et cibles connectées.

DisplayConfigSetDeviceInfo peut uniquement être utilisé pour définir DISPLAYCONFIG_DEVICE_INFO_SET_XXX type d’informations. DisplayConfigSetDeviceInfo échoue si le membre de type de DISPLAYCONFIG_DEVICE_INFO_HEADER est défini sur l’une des valeurs DISPLAYCONFIG_DEVICE_INFO_GET_XXX.

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)

Voir aussi

DISPLAYCONFIG_DEVICE_INFO_HEADER

DisplayConfigGetDeviceInfo