DisplayTaskResult.SourceStatus プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DisplayTaskPool.TryExecuteTask が返される直前の DisplaySource の現在の状態を取得します。
public:
property DisplaySourceStatus SourceStatus { DisplaySourceStatus get(); };DisplaySourceStatus SourceStatus();public DisplaySourceStatus SourceStatus { get; }var displaySourceStatus = displayTaskResult.sourceStatus;Public ReadOnly Property SourceStatus As DisplaySourceStatusプロパティ値
DisplayTaskPool.TryExecuteTask が返される直前の DisplaySource の現在の状態を表す DisplaySourceStatus。
注釈
スタンドアロンの DisplaySource.Status プロパティにアクセスして、DisplaySourceStatus (ディスプレイ ソースの状態を表す) を取得することもできます。
最後に要求された存在に影響を与える可能性のあるシステム状態の全体像を提供するために、 DisplayTaskPool.TryExecuteTask の状態が返されます。
DisplayTaskResult.PresentStatus が DisplaySource を指す値を返す場合、SourceStatus プロパティは、DisplaySource が原因で TryExecuteTask によってヒットしたさまざまなエラー状態を特定するのに役立ちます。 DirectDisplay クライアントも DisplaySource.StatusChanged イベントに登録する 必要があります。 これは、 DisplaySource の状態が非同期的に TryExecuteTask に変更される可能性があり、 TryExecuteTask を再試行するタイミングを示すためです。
SourceStatus の一般的な使用方法の 1 つは、TryExecuteTask が PresentStatus で SourceStatusPreventedPresent を返す場合です。 その場合、 SourceStatus が PoweredOff の場合、 は、物理表示パスがカーネルの観点から電源オフと見なされるため、最新の存在がグラフィックス スケジューラでキューに入れられなかったシナリオを指定します。 次に、DisplaySourceStatus 変更イベントを確認し、ディスプレイの電源が再びオンになったときにチェックしてから、TryExecuteTask の呼び出しを再開する必要があります。