DISPLAYCONFIG_PATH_TARGET_INFO structure (wingdi.h)

Article
08/27/2023

La structure DISPLAYCONFIG_PATH_TARGET_INFO contient des informations de cible pour un chemin d’accès unique.

Syntaxe

typedef struct DISPLAYCONFIG_PATH_TARGET_INFO {
  LUID                                  adapterId;
  UINT32                                id;
  union {
    UINT32 modeInfoIdx;
    struct {
      UINT32 desktopModeInfoIdx : 16;
      UINT32 targetModeInfoIdx : 16;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY outputTechnology;
  DISPLAYCONFIG_ROTATION                rotation;
  DISPLAYCONFIG_SCALING                 scaling;
  DISPLAYCONFIG_RATIONAL                refreshRate;
  DISPLAYCONFIG_SCANLINE_ORDERING       scanLineOrdering;
  BOOL                                  targetAvailable;
  UINT32                                statusFlags;
} DISPLAYCONFIG_PATH_TARGET_INFO;

Membres

adapterId

Identificateur de l’adaptateur sur lequel se trouve le chemin d’accès.

id

Identificateur cible sur l’adaptateur spécifié auquel ce chemin d’accès est lié.

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

Index valide dans la table d’informations de mode qui contient les informations de mode cible pour ce chemin d’accès uniquement lorsque DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE n’est pas défini. Si les informations du mode cible ne sont pas disponibles, la valeur de modeInfoIdx est DISPLAYCONFIG_PATH_MODE_IDX_INVALID.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx

Index valide dans le tableau de modes de l’entrée DISPLAYCONFIG_DESKTOP_IMAGE_INFO qui contient les informations sur le mode Bureau pour ce chemin d’accès uniquement lorsque DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE est défini. S’il n’existe aucune entrée pour cela dans le tableau de mode, la valeur de desktopModeInfoIdx est DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID. Prise en charge à partir de Windows 10.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

Index valide dans le tableau de modes de l’entrée DISPLAYCONFIG_TARGET_MODE qui contient les informations de mode cible pour ce chemin d’accès uniquement lorsque DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE est défini. S’il n’existe aucune entrée pour cela dans le tableau de mode, la valeur de targetModeInfoIdx est DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Prise en charge à partir de Windows 10.

outputTechnology

Type de connecteur de la cible. Pour obtenir la liste des valeurs possibles, consultez le type énuméré DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY .

rotation

Valeur qui spécifie la rotation de la cible. Pour obtenir la liste des valeurs possibles, consultez le type énuméré DISPLAYCONFIG_ROTATION .

scaling

Valeur qui spécifie la façon dont l’image source est mise à l’échelle sur la cible. Pour obtenir la liste des valeurs possibles, consultez le type énuméré DISPLAYCONFIG_SCALING . Pour plus d’informations sur la mise à l’échelle, consultez Mise à l’échelle de l’image de bureau.

refreshRate

Structure DISPLAYCONFIG_RATIONAL qui spécifie la fréquence d’actualisation de la cible. Si l’appelant spécifie des informations sur le mode cible, le système d’exploitation utilise à la place la fréquence d’actualisation stockée dans le membre vSyncFreq de la structure DISPLAYCONFIG_VIDEO_SIGNAL_INFO . Dans ce cas, l’appelant spécifie cette valeur dans le membre targetVideoSignalInfo de la structure DISPLAYCONFIG_TARGET_MODE . Une fréquence d’actualisation avec le numérateur et le dénominateur définis sur zéro indique que l’appelant ne spécifie pas de fréquence d’actualisation et que le système d’exploitation doit utiliser la fréquence d’actualisation la plus optimale disponible. Dans ce cas, dans un appel à la fonction SetDisplayConfig , l’appelant doit définir le membre scanLineOrdering sur la valeur DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED ; Sinon, SetDisplayConfig échoue.

scanLineOrdering

Valeur qui spécifie l’ordre de ligne d’analyse de la sortie sur la cible. Pour obtenir la liste des valeurs possibles, consultez le type énuméré DISPLAYCONFIG_SCANLINE_ORDERING . Si l’appelant spécifie des informations sur le mode cible, le système d’exploitation utilise plutôt l’ordre de ligne d’analyse stocké dans le membre scanLineOrdering de la structure DISPLAYCONFIG_VIDEO_SIGNAL_INFO . Dans ce cas, l’appelant spécifie cette valeur dans le membre targetVideoSignalInfo de la structure DISPLAYCONFIG_TARGET_MODE .

targetAvailable

Valeur booléenne qui spécifie si la cible est disponible. TRUE indique que la cible est disponible.

Étant donné que la nature asynchrone de la topologie d’affichage change lorsqu’un moniteur est supprimé, un chemin d’accès peut toujours être marqué comme actif même si le moniteur a été supprimé. Dans ce cas, targetAvailable peut être FALSE pour un chemin actif. Il s’agit généralement d’une situation temporaire qui change une fois que le système d’exploitation prend des mesures sur la suppression du moniteur.

statusFlags

Or au niveau du bit des valeurs d’indicateur qui indique le status de la cible. Les valeurs suivantes sont admises :

Valeur	Signification
DISPLAYCONFIG_TARGET_IN_USE 0x00000001	La cible est en cours d’utilisation sur un chemin actif.
DISPLAYCONFIG_TARGET_FORCIBLE 0x00000002	La sortie peut être forcée sur cette cible même si aucun moniteur n’est détecté.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT 0x00000004	La sortie est actuellement forcée de manière persistante au démarrage.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH 0x00000008	La sortie est actuellement forcée de manière persistante.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM 0x00000010	La sortie est actuellement forcée d’une manière non persistante.
DISPLAYCONFIG_TARGET_IS_HMD 0x00000020	La sortie est un écran monté en tête (HMD). Ce chemin d’accès est retourné uniquement à partir de QueryDisplayConfig à l’aide de l’indicateur QDC_INCLUDE_HMD. Pris en charge à partir du Windows 10 Creators Update (version 1703).

Remarques

Une structure DISPLAYCONFIG_PATH_TARGET_INFO est spécifiée dans le membre targetInfo d’une structure DISPLAYCONFIG_PATH_INFO .

Une cible correspond au nombre de sorties vidéo possibles sur une carte graphique. Toutefois, ce nombre n’équivaut pas au nombre de connecteurs physiques sur la carte graphique. Chaque connecteur expose un certain nombre de cibles qui incluent la compatibilité descendante avec une technologie de connecteur plus ancienne. Par exemple, un connecteur DVI expose une cible DVI, ainsi qu’une cible VGA. Un connecteur DisplayPort, qui a été introduit en 2006, expose les cibles DisplayPort, HDMI, DVI, tv héritée et VGA.

Le membre statusFlags est défini lorsque vous appelez la fonction QueryDisplayConfig .