DISPLAYCONFIG_PATH_TARGET_INFO structure (wingdi.h)
The DISPLAYCONFIG_PATH_TARGET_INFO structure contains target information for a single path.
Syntax
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
The identifier of the adapter that the path is on.
id
The target identifier on the specified adapter that this path relates to.
DUMMYUNIONNAME
DUMMYUNIONNAME.modeInfoIdx
A valid index into the mode information table that contains the target mode information for this path only when DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE is not set. If target mode information is not available, the value of modeInfoIdx is DISPLAYCONFIG_PATH_MODE_IDX_INVALID.
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx
A valid index into the mode array of the DISPLAYCONFIG_DESKTOP_IMAGE_INFO entry that contains the desktop mode information for this path only when DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE is set. If there is no entry for this in the mode array, the value of desktopModeInfoIdx is DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID. Supported starting in Windows 10.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx
A valid index into the mode array of the DISPLAYCONFIG_TARGET_MODE entry that contains the target mode information for this path only when DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE is set. If there is no entry for this in the mode array, the value of targetModeInfoIdx is DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Supported starting in Windows 10.
outputTechnology
The target's connector type. For a list of possible values, see the DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY enumerated type.
rotation
A value that specifies the rotation of the target. For a list of possible values, see the DISPLAYCONFIG_ROTATION enumerated type.
scaling
A value that specifies how the source image is scaled to the target. For a list of possible values, see the DISPLAYCONFIG_SCALING enumerated type. For more information about scaling, see Scaling the Desktop Image.
refreshRate
A DISPLAYCONFIG_RATIONAL structure that specifies the refresh rate of the target. If the caller specifies target mode information, the operating system will instead use the refresh rate that is stored in the vSyncFreq member of the DISPLAYCONFIG_VIDEO_SIGNAL_INFO structure. In this case, the caller specifies this value in the targetVideoSignalInfo member of the DISPLAYCONFIG_TARGET_MODE structure. A refresh rate with both the numerator and denominator set to zero indicates that the caller does not specify a refresh rate and the operating system should use the most optimal refresh rate available. For this case, in a call to the SetDisplayConfig function, the caller must set the scanLineOrdering member to the DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED value; otherwise, SetDisplayConfig fails.
scanLineOrdering
A value that specifies the scan-line ordering of the output on the target. For a list of possible values, see the DISPLAYCONFIG_SCANLINE_ORDERING enumerated type. If the caller specifies target mode information, the operating system will instead use the scan-line ordering that is stored in the scanLineOrdering member of the DISPLAYCONFIG_VIDEO_SIGNAL_INFO structure. In this case, the caller specifies this value in the targetVideoSignalInfo member of the DISPLAYCONFIG_TARGET_MODE structure.
targetAvailable
A Boolean value that specifies whether the target is available. TRUE indicates that the target is available.
Because the asynchronous nature of display topology changes when a monitor is removed, a path might still be marked as active even though the monitor has been removed. In such a case, targetAvailable could be FALSE for an active path. This is typically a transient situation that will change after the operating system takes action on the monitor removal.
statusFlags
A bitwise OR of flag values that indicates the status of the target. The following values are supported:
Remarks
A DISPLAYCONFIG_PATH_TARGET_INFO structure is specified in the targetInfo member of a DISPLAYCONFIG_PATH_INFO structure.
A target corresponds to the number of possible video outputs on a display adapter. This number, however, does not equate to the number of physical connectors on the display adapter. Each connector exposes a number of targets that includes backward compatibility with older connector technology. For example, a DVI connector exposes a DVI target, as well as a VGA target. A DisplayPort connector, which was introduced in 2006, exposes DisplayPort, HDMI, DVI, legacy TV, and VGA targets.
The statusFlags member is set when you call the QueryDisplayConfig function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 7 Client. |
| Header | wingdi.h (include Windows.h) |
See also
DISPLAYCONFIG_SCANLINE_ORDERING
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for