DisplayTaskResult.SourceStatus Propriété

public:
 property DisplaySourceStatus SourceStatus { DisplaySourceStatus get(); };

DisplaySourceStatus SourceStatus();

public DisplaySourceStatus SourceStatus { get; }

var displaySourceStatus = displayTaskResult.sourceStatus;

Public ReadOnly Property SourceStatus As DisplaySourceStatus

Valeur de propriété

DisplaySourceStatus représentant la status actuelle de DisplaySource immédiatement avant le retour de DisplayTaskPool.TryExecuteTask.

Remarques

Vous pouvez également obtenir un DisplaySourceStatus (représentant le status d’une source d’affichage) en accédant à la propriété DisplaySource.Status autonome.

L’état est retourné pour DisplayTaskPool.TryExecuteTask afin de fournir une image complète de l’état du système qui a potentiellement affecté le dernier présent demandé.

Lorsque DisplayTaskResult.PresentStatus renvoie une valeur pointant vers un DisplaySource, la propriété SourceStatus est utile pour déterminer les différentes conditions d’erreur atteintes par TryExecuteTask en raison de DisplaySource. Votre client DirectDisplay doit également s’inscrire à l’événement DisplaySource.StatusChanged . Cela est dû au fait que la status d’un DisplaySource peut également passer de façon asynchrone à TryExecuteTask, et il vous donnera une indication sur le moment où réessayer TryExecuteTask.

Une utilisation courante de SourceStatus est quand TryExecuteTask retourne SourceStatusPreventedPresent dans PresentStatus. Dans ce cas, si SourceStatus est PoweredOff, cela spécifie un scénario où le dernier présent n’a pas été mis en file d’attente dans le planificateur graphique, car le chemin d’affichage physique est considéré comme hors tension du point de vue du noyau. Vous devez ensuite rechercher l’événement de modification DisplaySourceStatus et case activée lorsque l’affichage est à nouveau allumé, puis reprendre l’appel de TryExecuteTask.

S’applique à

Voir aussi

• DisplaySource
• TryExecuteTask(DisplayTask)