DISPLAYCONFIG_PATH_TARGET_INFO struttura (wingdi.h)

Articolo
08/27/2023

La struttura DISPLAYCONFIG_PATH_TARGET_INFO contiene informazioni di destinazione per un singolo percorso.

Sintassi

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;

Members

adapterId

Identificatore dell'adapter in cui si trova il percorso.

id

Identificatore di destinazione nell'adattatore specificato a cui si riferisce questo percorso.

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

Indice valido nella tabella informazioni sulla modalità che contiene le informazioni sulla modalità di destinazione per questo percorso solo quando DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE non è impostato. Se le informazioni sulla modalità di destinazione non sono disponibili, il valore di modeInfoIdx è DISPLAYCONFIG_PATH_MODE_IDX_INVALID.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx

Indice valido nella matrice di modalità della voce DISPLAYCONFIG_DESKTOP_IMAGE_INFO contenente le informazioni sulla modalità desktop per questo percorso solo quando viene impostato DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE. Se nella matrice in modalità non è presente alcuna voce, il valore di desktopModeInfoIdx è DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID. Supportato a partire da Windows 10.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

Indice valido nella matrice di modalità della voce DISPLAYCONFIG_TARGET_MODE contenente le informazioni sulla modalità di destinazione per questo percorso solo quando viene impostato DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE. Se nella matrice in modalità non è presente alcuna voce, il valore di targetModeInfoIdx è DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Supportato a partire da Windows 10.

outputTechnology

Tipo di connettore di destinazione. Per un elenco di valori possibili, vedere il DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY tipo enumerato.

rotation

Valore che specifica la rotazione della destinazione. Per un elenco di valori possibili, vedere il tipo enumerato DISPLAYCONFIG_ROTATION .

scaling

Valore che specifica come l'immagine di origine viene ridimensionata alla destinazione. Per un elenco di valori possibili, vedere il DISPLAYCONFIG_SCALING tipo enumerato. Per altre informazioni sulla scalabilità, vedere Ridimensionamento dell'immagine desktop.

refreshRate

Struttura DISPLAYCONFIG_RATIONAL che specifica la frequenza di aggiornamento della destinazione. Se il chiamante specifica le informazioni sulla modalità di destinazione, il sistema operativo userà invece la frequenza di aggiornamento archiviata nel membro vSyncFreq della struttura DISPLAYCONFIG_VIDEO_SIGNAL_INFO . In questo caso, il chiamante specifica questo valore nel membro targetVideoSignalInfo della struttura DISPLAYCONFIG_TARGET_MODE . Una frequenza di aggiornamento con il numeratore e il denominatore impostato su zero indica che il chiamante non specifica una frequenza di aggiornamento e il sistema operativo deve usare la frequenza di aggiornamento più ottimale disponibile. Per questo caso, in una chiamata alla funzione SetDisplayConfig , il chiamante deve impostare il membro scanLineOrdering sul valore DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED; in caso contrario, SetDisplayConfig ha esito negativo.

scanLineOrdering

Valore che specifica l'ordinamento della riga di analisi dell'output nella destinazione. Per un elenco di valori possibili, vedere il DISPLAYCONFIG_SCANLINE_ORDERING tipo enumerato. Se il chiamante specifica le informazioni sulla modalità di destinazione, il sistema operativo userà invece l'ordinamento della riga di analisi archiviato nel membro scanLineOrdering della struttura DISPLAYCONFIG_VIDEO_SIGNAL_INFO . In questo caso, il chiamante specifica questo valore nel membro targetVideoSignalInfo della struttura DISPLAYCONFIG_TARGET_MODE .

targetAvailable

Valore booleano che specifica se la destinazione è disponibile. TRUE indica che la destinazione è disponibile.

Poiché la natura asincrona della topologia di visualizzazione cambia quando viene rimosso un monitoraggio, un percorso potrebbe comunque essere contrassegnato come attivo anche se il monitoraggio è stato rimosso. In tal caso, targetAvailable potrebbe essere FALSE per un percorso attivo. Si tratta in genere di una situazione temporanea che cambierà dopo l'azione del sistema operativo sulla rimozione del monitoraggio.

statusFlags

Or bit per bit dei valori del flag che indica lo stato della destinazione. Sono supportati i valori seguenti:

Valore	Significato
DISPLAYCONFIG_TARGET_IN_USE 0x00000001	La destinazione è in uso in un percorso attivo.
DISPLAYCONFIG_TARGET_FORCIBLE 0x00000002	L'output può essere forzato su questa destinazione anche se non viene rilevato un monitoraggio.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT 0x00000004	L'output è attualmente forzato in modo permanente di avvio.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH 0x00000008	L'output è attualmente forzato in modo permanente.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM 0x00000010	L'output è attualmente forzato in modo nonpersistente.
DISPLAYCONFIG_TARGET_IS_HMD 0x00000020	L'output è un display montato sulla testa (HMD). Tale percorso viene restituito solo da QueryDisplayConfig usando il flag di QDC_INCLUDE_HMD. Supportato a partire dalla Windows 10 Creators Update (versione 1703).

Commenti

Una struttura DISPLAYCONFIG_PATH_TARGET_INFO viene specificata nel membro targetInfo di una struttura DISPLAYCONFIG_PATH_INFO .

Una destinazione corrisponde al numero di possibili output video in una scheda di visualizzazione. Questo numero, tuttavia, non equivale al numero di connettori fisici nella scheda di visualizzazione. Ogni connettore espone una serie di destinazioni che includono la compatibilità con le versioni precedenti con la tecnologia del connettore precedente. Ad esempio, un connettore DVI espone una destinazione DVI, nonché una destinazione VGA. Un connettore DisplayPort, introdotto nel 2006, espone DisplayPort, HDMI, DVI, TV legacy e destinazioni VGA.

Il membro statusFlags viene impostato quando si chiama la funzione QueryDisplayConfig .