DXGK_QUERYINTEGRATEDDISPLAYOUT2 structure (d3dkmddi.h)

Utilisé lors d’une requête pour la sortie d’affichage intégrée.

Syntaxe

typedef struct _DXGK_QUERYINTEGRATEDDISPLAYOUT2 {
  [out] DXGK_INTEGRATEDDISPLAYFLAGS        Flags;
  [out] D3DKMDT_VIDEO_SIGNAL_INFO          NativeTiming;
  [out] DXGK_MONITORLINKINFO_CAPABILITIES  LinkCapabilities;
  [out] DXGK_COLORIMETRY                   Colorimetry;
  [out] DXGK_DISPLAY_TECHNOLOGY            DisplayTechnology;
  [out] DXGK_DISPLAY_USAGE                 IntendedUsage;
  [out] BYTE                               Instance;
  [out] DXGK_DISPLAY_DESCRIPTOR_TYPE       DescriptorType;
  [out] D3DKMDT_WIRE_FORMAT_AND_PREFERENCE DitheringSupport;
} DXGK_QUERYINTEGRATEDDISPLAYOUT2, *PDXGK_QUERYINTEGRATEDDISPLAYOUT2;

Membres

[out] Flags

Pointeur vers une structure DXGK_INTEGRATEDDISPLAYFLAGS qui décrit les propriétés simples d’un affichage intégré. Les valeurs d’orientation de 0 degré indiquent que le descripteur ne remplace pas.

[out] NativeTiming

Pointeur vers une structure [D3DKMDT_VIDEO_SIGNAL_INFO]/d3dkmdt/ns-d3dkmdt-_d3dkmdt_video_signal_info.md) qui contient des informations sur un minutage natif de l’affichage intégré. Doit être mis à zéro pour indiquer qu’aucun remplacement n’est indiqué. Cette valeur remplace le minutage natif dans le descripteur. Étant donné que le pilote est chargé de fournir le descripteur, la seule utilisation attendue de ce remplacement est de décrire un minutage qui ne peut pas être décrit par un EDID, de toute évidence, un affichage qui a plus de 4 095 pixels adressables dans les deux sens. Si un remplacement NativeTiming est fourni, le système d’exploitation n’appelle pas DxgkDdiRecommendMonitorModes pour cette cible. En règle générale, les panneaux intégrés ne prennent pas en charge un grand nombre de minutages et le pilote doit être bien adapté à l’EDID fourni. Si le pilote doit décrire plusieurs remplacements pour les modes d’analyse, il doit laisser la structure NativeTiming à zéro et signaler tous les remplacements à l’aide de DxgkDdiRecommendMonitorModes.

[out] LinkCapabilities

Pointeur vers une structure DXGK_MONITORLINKINFO_CAPABILITIES qui décrit les fonctionnalités de liaison pour piloter le moniteur. Il s’agit des mêmes fonctionnalités de liaison que celles que le système d’exploitation interroge à partir d’un affichage externe après une connexion à chaud. Étant donné qu’un affichage intégré est exposé lors de l’initialisation du pilote d’adaptateur, les fonctionnalités sont décrites directement plutôt que d’effectuer un appel DDI supplémentaire.

À compter de WDDM 2.6, ce membre est utilisé pour signaler la prise en charge de la synchronisation.

[out] Colorimetry

Remplacements liés à la colorimétrie pour l’affichage. Consultez la description des DXGK_COLORIMETRY pour connaître les définitions de champs et les restrictions sur les combinaisons de champs.

[out] DisplayTechnology

Valeur qui représente la technologie de l’affichage. Utilisé pour optimiser l’expérience, par exemple l’activation d’un thème plus sombre avec un contenu bleu réduit sur DXGK_DT_OLED écrans.

[out] IntendedUsage

Valeur qui indique l’utilisation prévue de l’affichage par le fabricant. La valeur signalée doit être DXGK_DU_GENERIC, sauf si le pilote dispose d’informations indiquant une utilisation plus spécifique. Si l’affichage intégré est destiné à être utilisé pour la réalité augmentée, la réalité virtuelle ou la sortie auxiliaire, le pilote doit disposer d’une gestion suffisamment spécifique pour pouvoir signaler l’utilisation correcte.

[out] Instance

Entier de base zéro pour le instance du panneau intégré. Permet de commander plusieurs panneaux intégrés. Les valeurs doivent être uniques et contiguës entre les cibles intégrées, mais elles ne doivent pas être signalées dans l’ordre.

[out] DescriptorType

Valeur pour indiquer le type de descripteur. Pour WDDM 2.4, cette valeur doit être DXGK_DDT_EDID. À partir de WDDM 2.5 et versions ultérieures, DXGK_DDT_EDID ou DXGK_DDT_DISPLAYID est autorisé.

[out] DitheringSupport

Champ D3DKMDT_WIRE_FORMAT_AND_PREFERENCE qui contient les indicateurs pour chaque format filaire. Le pilote doit définir le bit de format filaire pour chaque format où le pilote et le matériel prennent en charge le tramage bénéfique pour la qualité de l’image lorsque le format de pixel source contient une précision plus élevée que le format de fil.

Remarques

Les champs fournissent des attributs de remplacement de l’affichage qui peuvent être fournis par un descripteur, mais qui ne peuvent pas être décrits par un EDID ou ont généralement manquant ou incorrect dans les EDID. En cas de conflit entre le descripteur et ces champs de remplacement, le système d’exploitation utilise les remplacements lorsqu’ils sont valides.

Le système d’exploitation case activée les champs et le pilote échoue si des champs sont jugés incohérents ou non valides. Pour la plupart des champs, la vérification de l’intégrité signifie simplement vérifier que les valeurs signalées sont dans la plage, mais que les champs Colorimetry, Instance et Descripteur ont une validation supplémentaire appliquée. Pour colorimétrie, consultez la description des DXGK_COLORIMETRY de validation. Les valeurs d’instance sont vérifiées pour être cohérentes entre tous les affichages intégrés, comme indiqué ci-dessus. Le descripteur doit être un EDID valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	d3dkmddi.h