DisplayConfigSetDeviceInfo, fonction (winuser.h)
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 |
|---|---|
|
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 sur lequel un pilote WDDM est 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 à distance. |
|
La taille du paquet que l’appelant passe n’est pas assez grande. |
|
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) |