Export (0) Print
Expand All

DISPLAYCONFIG_PATH_TARGET_INFO structure

The DISPLAYCONFIG_PATH_TARGET_INFO structure contains target information for a single path.

Syntax


typedef struct DISPLAYCONFIG_PATH_TARGET_INFO {
  LUID                                  adapterId;
  UINT32                                id;
  UINT32                                modeInfoIdx;
  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.

modeInfoIdx

The index into the mode information table that contains the target mode information for this path. If target mode information is not available, the value of modeInfoIdx is DISPLAYCONFIG_PATH_MODE_IDX_INVALID.

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:

DISPLAYCONFIG_TARGET_IN_USE

Target is in use on an active path.

DISPLAYCONFIG_TARGET_FORCIBLE

The output can be forced on this target even if a monitor is not detected.

DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT

Output is currently being forced in a boot-persistent manner.

DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH

Output is currently being forced in a path-persistent manner.

DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM

Output is currently being forced in a nonpersistent manner.

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

Version

Available in Windows 7 Client.

Header

Wingdi.h (include Windows.h)

See also

DISPLAYCONFIG_PATH_INFO
DISPLAYCONFIG_RATIONAL
DISPLAYCONFIG_ROTATION
DISPLAYCONFIG_SCALING
DISPLAYCONFIG_SCANLINE_ORDERING
DISPLAYCONFIG_TARGET_MODE
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY
DISPLAYCONFIG_VIDEO_SIGNAL_INFO
QueryDisplayConfig

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft