DisplayPath.FindModes(DisplayModeQueryOptions) Method

Definition

Queries the driver to determine the valid mode combinations that can be applied to this DisplayPath. Any properties that have already been set on this path are used as constraints to limit the set of modes returned.

public:
 virtual IVectorView<DisplayModeInfo ^> ^ FindModes(DisplayModeQueryOptions flags) = FindModes;
IVectorView<DisplayModeInfo> FindModes(DisplayModeQueryOptions const& flags);
public IReadOnlyList<DisplayModeInfo> FindModes(DisplayModeQueryOptions flags);
function findModes(flags)
Public Function FindModes (flags As DisplayModeQueryOptions) As IReadOnlyList(Of DisplayModeInfo)

Parameters

flags
DisplayModeQueryOptions

A DisplayModeQueryOptions value containing extended options for filtering the resulting modes.

Returns

A collection containing zero or more modes that the driver reports could be successfully applied to this path. If the collection is empty, then either the driver doesn't support applying the DisplayState, or the supplied options are too constraining.

Remarks

Filtering the returned modes using flags, or by setting some properties to constrain the mode enumeration, can provide a significant performance improvement. This method is very expensive if unconstrained, as the driver will be queried directly and may perform complex calculations to determine the union of supported modes.

Applies to