IddCxAdapterDisplayConfigUpdate2, fonction (iddcx.h)
Un pilote distant peut appeler IddCxAdapterDisplayConfigUpdate2 pour autoriser un client à 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 des arguments d’entrée vers la fonction.
Valeur de retour
IddCxAdapterDisplayConfigUpdate2 retourne STATUS_SUCCESS en cas de réussite ; sinon, elle 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 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 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.
Les modes de contrôle (définition de l’indicateur de IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID pour un chemin) ont 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 fournis doivent l’avoir défini
- Lorsque IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID est fourni sur tous les chemins d’accès, tous les chemins actifs actuellement non présents dans la liste de chemins deviennent inactifs
- Si seuls les indicateurs nonIDDCX_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 |
|---|---|---|
| DTS | Non | Non |
| SDRWCG | Oui | Non |
| HDR | Oui | Oui |
Tout d’abord par rapport aux appels suivants à IddCxAdapterDisplayConfigUpdate2
La première fois qu’un chemin d’accès est inclus dans un IddCxAdapterDisplayConfigUpdate2 l’appel a des exigences différentes que les heures suivantes. Le tableau suivant présente 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 obtiendrait-il les informations |
|---|---|---|---|
| Mode | Oui | Oui | QueryDisplayConfig fournit une configuration d’affichage du client et WM_DISPLAYCHANGE est envoyé lors des modifications de configuration d’affichage ; AdvancedColorInfo.CurrentAdvancedColorKind donne 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’est passé | Non | Non nécessaire si EDID est passé |
| Colorimétrie | Oui pour le mode couleur non SDR | Oui | La plupart des champs des champs AdvancedColorInfo correspondants |
| Niveau blanc SDR | Oui pour le mode couleur HDR, la valeur par défaut est de 80 nits | Oui | AdvancedColorInfo.SdrWhiteLevelInNits, consultez DirectX avec couleur avancée sur 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 de la fonctionnalité de système d’exploitation sous-jacente, la prise en charge des pilotes demandant des modes de 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 en 2024. Un pilote peut utiliser la fonction IddCxGetVersion pour déterminer le système d’exploitation sur lequel ils s’exécutent. Le tableau suivant décrit les modes de couleur qu’un pilote peut demander en fonction du descripteur du moniteur précédemment fourni au système d’exploitation :
| Type Edid | 22H2 Septembre Mettre à jour les modes de couleur possibles | Mise en production de la plateforme en modes de couleur possibles en 2024 |
|---|---|---|
| Aucun | SDR, HDR | SDR, SDRWCG, HDR |
| DTS | SDR, SDRWCG | SDR, SDRWCG |
| HDR | SDR, HDR | SDR, SDRWCG, HDR |
Exemples
Voici quelques exemples de chemins à inclure dans les appels suivants IddCxAdapterDisplayConfigUpdate2 suivis. Au début de chaque scénario, une session distante a les chemins d’accès suivants configurés :
| Moniteur | Résolution | Position du bureau | Mode couleur |
|---|---|---|---|
| 1 | 1920x1080 @ 30Hz | 0,0 | DTS |
| 2 | 1024x768 @ 30Hz | 1024,0 | SDRWCG |
| 3 | 3840x2160 @ 30Hz | 0,1848 | HDR |
Scénario 1 : modifier la position du bureau du moniteur 3 à gauche du moniteur 1
| Moniteur | Drapeaux | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données en mode actuel |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données en mode actuel |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Remplacez la position du bureau par -3840,0 |
Scénario 2 : Modifier le moniteur 2 de SDRWCG à SDR
| Moniteur | Drapeaux | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données en 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 en mode actuel |
Scénario 3 : Modifier le moniteur 1 de SDR en HDR
| Moniteur | Drapeaux | 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 en mode actuel |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données en mode actuel |
Scénario 4 : modifier le facteur d’échelle de Monitor 2
| Moniteur | Drapeaux | 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
| Moniteur | Drapeaux | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données en mode actuel |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Aucune modification apportée aux données en mode actuel, définir un nouveau facteur d’échelle |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Remplacez la position du bureau par -3840,0 |
Scénario 6 : supprimer le moniteur 2 de la configuration actuelle
| Moniteur | Drapeaux | Détails |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données en mode actuel |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Aucune modification apportée aux données en mode actuel |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Mise à jour de septembre de Windows 11 version 22H2 (IddCx version 1.10) |
| d’en-tête | iddcx.h |