DisplayState.TryFunctionalize(DisplayStateFunctionalizeOptions) メソッド

定義

名前空間:

Windows.Devices.Display.Core

指定されたすべての DisplayPath プロパティを制約として指定したすべてのパスで最適なモードを評価することによって、この DisplayState を "機能化" しようとします。 次に、このメソッド (必要に応じて「 備考」を参照) は、すべての DisplayPath プロパティと DisplayView プロパティを機能化の結果で更新します。 特に、 すべての DisplayPath プロパティと DisplayView プロパティが null に設定されると、その値が計算されて設定されます。

public:
 virtual DisplayStateOperationResult ^ TryFunctionalize(DisplayStateFunctionalizeOptions options) = TryFunctionalize;

DisplayStateOperationResult TryFunctionalize(DisplayStateFunctionalizeOptions const& options);

public DisplayStateOperationResult TryFunctionalize(DisplayStateFunctionalizeOptions options);

function tryFunctionalize(options)

Public Function TryFunctionalize (options As DisplayStateFunctionalizeOptions) As DisplayStateOperationResult

パラメーター

options

DisplayStateFunctionalizeOptions

使用する DisplayStateFunctionalizeOptions。

戻り値

DisplayStateOperationResult

操作の成功または失敗を詳細に示す DisplayStateOperationResult 値。

注釈

ValidateTopologyOnly オプションを使用して、すべての DisplayPath プロパティが機能化の結果で更新されないようにします。

TryApply を呼び出すと、システムに適用する前に状態も暗黙的に機能しますが、TryApply はこの状態の DisplayPath プロパティを機能化の結果で更新することはありません。

DisplayState を機能させる操作は、ディスプレイ ドライバーのクエリを実行し、考えられる多くのモードを比較する必要があるため、非常に負荷の高い操作になる可能性があります。 通常、このメソッドを呼び出す (または TryApply を呼び出す) 前に DisplayPath プロパティをより多く設定すると、操作の方が安くなります。これは、特定のパスで "最適" モードを評価するために必要な作業量が減るのでです。

TryApply は常に Try Functionalize よりもコストが高いため、TryFunctionalize を使用して、TryApply を呼び出す前に現在の状態を機能可能にできるかどうかを判断することをお勧めします。 Try Functionalize が成功すると、TryApply の後続の呼び出しは、モードの機能化の作業を行う必要がなくなったため、安価になります。