DisplayTarget Class


Represents a slice in time of a logical "target" for the display pipeline. This is typically analogous to a physical connector on a GPU, such as an HDMI port, but it can be a virtual target representing daisy-chained DisplayPort targets.

public ref class DisplayTarget sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DisplayTarget final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
public sealed class DisplayTarget
Public NotInheritable Class DisplayTarget
Object Platform::Object IInspectable DisplayTarget

Windows requirements

Device family
Windows 10, version 1809 (introduced in 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v7.0)


A DisplayTarget object is immutable, except for the IsStale property. If IsStale is true, then you can re-enumerate the latest state for all DisplayTarget objects by calling DisplayManager.GetCurrentTargets.



Gets the adapter that enumerates this DisplayTarget.


Gets a driver-defined identifier for this target that uniquely identifies the connector across device starts and reboots. Note that this identifier is only unique within its adapter, and does not refer to the connected monitor at all.


Gets the PnP device interface of any monitor connected to the target when the object was created, or null if no monitor was connected.


Gets a Boolean value indicating whether a monitor was connected to this DisplayTarget when it was created.


Gets a value indicating whether the system display state has changed since this DisplayTarget was created.


Returns a Boolean value indicating whether this target supports virtual modes.


Returns a Boolean value indicating whether this target supports virtual/software clone.


Gets a value representing how a monitor connected to the target is virtually persisted when the hardware no longer reports any connected monitor.


Reserved for future use.


Gets a value representing a stable monitor identifier.


Gets a value representing the usage kind.



Determines whether all properties of the target are equivalent to another target, indicating that there has been no change to the target.


Determines whether this target object refers to the same underlying hardware target as another target object, by comparing the Adapter and the AdapterRelativeId properties. Since new DisplayTarget objects are created on each call to GetCurrentTargets, this method can be used to match previously discovered targets to newly created targets.


Tries to retrieve an object describing the monitor currently connected to this DisplayTarget. This method can fail or return a different monitor than the properties on the DisplayTarget describe if monitors have been plugged or unplugged from the DisplayTarget since the DisplayTarget object was created. IsStale returns true if the monitor might have changed since the DisplayTarget was created.

Applies to