structure DISPLAYCONFIG_TARGET_DEVICE_NAME (wingdi.h)

Article
03/13/2024

La structure DISPLAYCONFIG_TARGET_DEVICE_NAME contient des informations sur la cible.

Syntaxe

typedef struct DISPLAYCONFIG_TARGET_DEVICE_NAME {
  DISPLAYCONFIG_DEVICE_INFO_HEADER       header;
  DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS flags;
  DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY  outputTechnology;
  UINT16                                 edidManufactureId;
  UINT16                                 edidProductCodeId;
  UINT32                                 connectorInstance;
  WCHAR                                  monitorFriendlyDeviceName[64];
  WCHAR                                  monitorDevicePath[128];
} DISPLAYCONFIG_TARGET_DEVICE_NAME;

Membres

header

Structure DISPLAYCONFIG_DEVICE_INFO_HEADER qui contient des informations sur la demande pour le nom de l’appareil cible. L’appelant doit définir le type membre de DISPLAYCONFIG_DEVICE_INFO_HEADER sur DISPLAYCONFIG_DEVICE_INFO_GET_TARGET_NAME et les membres adapterId et id de DISPLAYCONFIG_DEVICE_INFO_HEADER à la cible pour laquelle l’appelant souhaite le nom de l’appareil cible. L’appelant doit définir la taille membre de DISPLAYCONFIG_DEVICE_INFO_HEADER sur au moins la taille de la structure DISPLAYCONFIG_TARGET_DEVICE_NAME.

flags

Structure DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS qui identifie, dans les indicateurs de champ binaire, des informations sur la cible.

outputTechnology

Valeur de l’énumération DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY qui spécifie le type de connecteur de la cible.

edidManufactureId

Identificateur de fabrication de l’edid (Extended Display Identification Data) du moniteur. Ce membre est défini uniquement lorsque le champ de bits edidIdsValid est défini dans le membre indicateurs .

edidProductCodeId

Code de produit du moniteur EDID. Ce membre est défini uniquement lorsque le champ de bits edidIdsValid est défini dans le membre indicateurs .

connectorInstance

L’instance nombre de cette cible particulière uniquement lorsque l’adaptateur a plusieurs cibles de ce type. Le connecteur instance est un nombre de base un consécutif qui est unique dans chaque adaptateur. S’il s’agit de la seule cible de ce type sur l’adaptateur, cette valeur est égale à zéro.

monitorFriendlyDeviceName[64]

Chaîne WCHAR terminée par NULL qui est le nom de l’appareil pour le moniteur. Ce nom peut être utilisé avec SetupAPI.dll pour obtenir le nom de l’appareil contenu dans le package d’installation.

monitorDevicePath[128]

Chaîne WCHAR terminée par null qui est le chemin d’accès au nom de l’appareil pour le moniteur. Ce chemin d’accès peut être utilisé avec SetupAPI.dll pour obtenir le nom de l’appareil contenu dans le package d’installation.

Remarques

Les données d’identification d’affichage étendues (EDID) sont un ensemble de données fournies par un affichage pour décrire ses fonctionnalités à une carte graphique. Les données EDID permettent à un ordinateur de détecter le type de moniteur qui y est connecté. Les données EDID incluent le nom du fabricant, le type de produit, les minutages pris en charge par l’affichage, la taille d’affichage, ainsi que d’autres caractéristiques d’affichage. EDID est défini par une norme publiée par la Video Electronics Standards Association (VESA).

Un objet d’appareil nommé a un chemin d’accès et un nom de la forme \Device\DeviceName. Il s’agit du nom de l’appareil de l’objet d’appareil.

Si une application appelle la fonction DisplayConfigGetDeviceInfo pour obtenir le nom du moniteur et Que DisplayConfigGetDeviceInfo ne peut pas obtenir le nom du moniteur ou que la cible est forcée sans moniteur connecté, la chaîne dans le membre monitorFriendlyDeviceName de la structure DISPLAYCONFIG_TARGET_DEVICE_NAME est une chaîne NULL et aucun indicateur de champ binaire dans la structure DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS n’est défini.