Fonction IddCxAdapterDisplayConfigUpdate2 (iddcx.h)
Un pilote distant peut appeler IddCxAdapterDisplayConfigUpdate2 pour permettre à un client d’indiquer au serveur comment mettre à jour la configuration du moniteur.
Syntaxe
HRESULT IddCxAdapterDisplayConfigUpdate2(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 *pInArgs
);
Paramètres
AdapterObject
[in] Objet IDDCX_ADAPTER de l’adaptateur distant pour lequel la configuration d’affichage est spécifiée.
pInArgs
[in] Pointeur vers une structure IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 contenant les arguments d’entrée de la fonction.
Valeur retournée
IddCxAdapterDisplayConfigUpdate2 retourne STATUS_SUCCESS en cas de réussite ; sinon, il retourne un code d’erreur approprié.
Remarques
Un pilote d’affichage indirect distant peut appeler IddCxAdapterDisplayConfigUpdate2 pour définir le mode, la colorimétrie et d’autres valeurs que le système d’exploitation doit utiliser pour un moniteur spécifique. Seuls les pilotes distants peuvent appeler cette fonction.
Pour plus d’informations sur la prise en charge HDR, consultez Mises à jour d’IddCx version 1.10.
La structure IDDCX_DISPLAYCONFIGPATH2 est définie de telle sorte que toutes les informations ne doivent pas être fournies dans chaque appel. Par exemple, certains chemins d’accès peuvent ne pas fournir de données de colorimétrie si le mode de couleur n’est pas HDR ou WCG, ou IddCxAdapterDisplayConfigUpdate2 peut être appelé pour mettre à jour uniquement le niveau blanc SDR si aucune modification de disposition n’est requise.
Le contrôle des modes (définition de l’indicateur IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID pour un chemin d’accès) comporte des règles et des clarifications supplémentaires :
- Si un chemin d’accès a IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID défini, tous les chemins d’accès fournis doivent l’avoir défini
- Lorsque IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID est fourni sur tous les chemins d’accès, tous les chemins d’accès actuellement actifs ne figurant pas dans la liste des chemins d’accès deviennent inactifs
- Si seuls les indicateurs non IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID sont définis, seuls les chemins d’accès à mettre à jour doivent être présents
- Selon le mode de couleur spécifié, des données supplémentaires peuvent être requises pour un chemin d’accès. Le tableau suivant indique quels indicateurs supplémentaires doivent être définis :
| Mode couleur | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID |
|---|---|---|
| SDR | Non | Non |
| SDRWCG | Oui | Non |
| HDR | Oui | Oui |
Premier appel à IddCxAdapterDisplayConfigUpdate2
La première fois qu’un chemin d’accès est inclus dans un appel IddCxAdapterDisplayConfigUpdate2 a des exigences différentes de celles des fois suivantes. Le tableau suivant décrit les exigences.
| Champ Chemin d’accès | Obligatoire dans l’appel initial pour le chemin d’accès | Peut être mis à jour après l’appel initial | Comment le client Windows peut-il obtenir les informations |
|---|---|---|---|
| Mode | Oui | Oui | QueryDisplayConfig fournit la configuration d’affichage du client et WM_DISPLAYCHANGE est envoyé lorsque la configuration d’affichage change ; AdvancedColorInfo.CurrentAdvancedColorKind donnera un mode couleur |
| Facteur d’échelle | Oui | Oui | Les pilotes peuvent utiliser la méthode utilisée pour IddCxAdapterDisplayConfigUpdate |
| Taille physique | Oui si aucun EDID n’a été transmis | No | Non nécessaire si EDID est passé |
| Colorimétrie | Oui pour le mode de couleur non SDR | Yes | La plupart des champs des champs AdvancedColorInfo correspondants |
| Niveau blanc SDR | Oui pour le mode de couleur HDR, la valeur par défaut est de 80 nits | Yes | AdvancedColorInfo.SdrWhiteLevelInNits, consultez DirectX avec couleur avancée sur les affichages HDR/SDR pour plus d’informations |
Différences de comportement lors de l’exécution sur Windows 11, version 22H2 Mise à jour de septembre
En raison des fonctionnalités du système d’exploitation sous-jacentes, la prise en charge des pilotes qui demandent des modes couleur HDR et WCG lors de l’exécution sur Windows 11, version 22H2 Septembre Update diffère légèrement de celle de l’exécution sur la version de la plateforme Windows à venir en 2024. Un pilote peut utiliser la fonction IddCxGetVersion pour déterminer sur quel système d’exploitation il s’exécute. Le tableau suivant décrit les modes de couleur qu’un pilote peut demander en fonction du descripteur de moniteur fourni précédemment au système d’exploitation :
| Type Edid | 22H2 Septembre Mettre à jour les modes de couleur possibles | Mise en production de la plateforme dans les modes couleurs possibles 2024 |
|---|---|---|
| None | SDR, HDR | SDR, SDRWCG, HDR |
| SDR | SDR, SDRWCG | SDR, SDRWCG |
| HDR | SDR, HDR | SDR, SDRWCG, HDR |
Exemples
Voici quelques exemples de chemins d’accès à inclure dans les appels IddCxAdapterDisplayConfigUpdate2 suivants. Au début de chaque scénario, les chemins d’accès suivants sont configurés pour une session distante :
| Monitor | Résolution | Position du bureau | Mode couleur |
|---|---|---|---|
| 1 | 1920x1080 à 30 Hz | 0,0 | SDR |
| 2 | 1024x768 à 30 Hz | 1024,0 | SDRWCG |
| 3 | 3840x2160 à 30 Hz | 0,1848 | HDR |
Scénario 1 : Modifier la position du bureau du moniteur 3 pour qu’elle soit à gauche du moniteur 1
| Monitor | Indicateurs | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Modifier la position du bureau sur -3840,0 |
Scénario 2 : changer le moniteur 2 de SDRWCG en SDR
| Monitor | Indicateurs | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Définir le nouveau mode de couleur |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
Scénario 3 – Changer le moniteur 1 de SDR en HDR
| Monitor | Indicateurs | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID | Définir le nouveau mode de couleur, la colorimétrie et le niveau blanc SDR |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
Scénario 4 – Modifier le facteur d’échelle de Monitor 2
| Monitor | Indicateurs | Détails |
|---|---|---|
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Définir un nouveau facteur d’échelle |
Scénario 5 : modifier le facteur d’échelle du moniteur 2 et la position de bureau du moniteur 3 à gauche du moniteur 1
| Monitor | Indicateurs | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Aucune modification des données du mode actuel, définir un nouveau facteur d’échelle |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Modifier la position du bureau sur -3840,0 |
Scénario 6 : supprimer le moniteur 2 de la configuration actuelle
| Monitor | Indicateurs | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données du mode actuel |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | mise à jour de septembre Windows 11 version 22H2 (IddCx version 1.10) |
| En-tête | iddcx.h |