Partager via


DISPLAYCONFIG_PATH_TARGET_INFO structure (wingdi.h)

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 .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans le client Windows 7.
En-tête wingdi.h (inclure Windows.h)

Voir aussi

DISPLAYCONFIG_PATH_INFO

DISPLAYCONFIG_RATIONAL

DISPLAYCONFIG_ROTATION

DISPLAYCONFIG_SCALING

DISPLAYCONFIG_SCANLINE_ORDERING

DISPLAYCONFIG_TARGET_MODE

DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY

DISPLAYCONFIG_VIDEO_SIGNAL_INFO

QueryDisplayConfig