DisplayTaskResult.SourceStatus Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene lo stato corrente di DisplaySource immediatamente prima che DisplayTaskPool.TryExecuteTask restituisca.
public:
property DisplaySourceStatus SourceStatus { DisplaySourceStatus get(); };DisplaySourceStatus SourceStatus();public DisplaySourceStatus SourceStatus { get; }var displaySourceStatus = displayTaskResult.sourceStatus;Public ReadOnly Property SourceStatus As DisplaySourceStatusValore della proprietà
Oggetto DisplaySourceStatus che rappresenta lo stato corrente di DisplaySource immediatamente prima che DisplayTaskPool.TryExecuteTask restituisca.
Commenti
È anche possibile ottenere un oggetto DisplaySourceStatus (che rappresenta lo stato di un'origine di visualizzazione) accedendo alla proprietà DisplaySource.Status autonoma.
Lo stato viene restituito per DisplayTaskPool.TryExecuteTask per fornire un quadro completo dello stato del sistema che ha potenzialmente interessato l'ultimo presente richiesto.
Quando DisplayTaskResult.PresentStatus restituisce un valore che punta a displaySource, la proprietà SourceStatus è utile per determinare diverse condizioni di errore soddisfatte da TryExecuteTask a causa di DisplaySource. Il client DirectDisplay deve anche registrarsi per l'evento DisplaySource.StatusChanged . Questo perché lo stato di un oggetto DisplaySource può anche cambiare in modo asincrono in TryExecuteTask e fornisce un'indicazione su quando ripetere TryExecuteTask.
Un utilizzo comune di SourceStatus è quando TryExecuteTask restituisce SourceStatusPreventedPresent in PresentStatus. In tal caso, se SourceStatus è PoweredOff, questo specifica uno scenario in cui il presente più recente non è stato accodato nell'utilità di pianificazione grafica perché il percorso di visualizzazione fisico viene considerato spento dal punto di vista del kernel. È quindi necessario cercare l'evento di modifica DisplaySourceStatus e controllare quando lo schermo è acceso di nuovo e quindi riprendere a chiamare TryExecuteTask.