DISPLAYCONFIG_PATH_TARGET_INFO struttura (wingdi.h)
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:
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 .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 Client. |
| Intestazione | wingdi.h (include Windows.h) |
Vedi anche
DISPLAYCONFIG_SCANLINE_ORDERING
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY