Partager via


DisplayManager Classe

Définition

Gère la propriété d’un ou plusieurs objets DisplayTarget et fournit des méthodes pour créer des objets DisplayState .

public ref class DisplayManager sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DisplayManager final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DisplayManager : System.IDisposable
Public NotInheritable Class DisplayManager
Implements IDisposable
Héritage
Object Platform::Object IInspectable DisplayManager
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Remarques

Cet objet implémenteIDisposableIClosable/, qui doit être utilisé pour révoquer la propriété de tous les objets DisplayTarget une fois qu’ils ne sont plus utilisés.

Méthodes

Close()

Révoque la propriété de tous les objets DisplayTarget appartenant à cette instance DisplayManager.

Create(DisplayManagerOptions)

Crée un instance DisplayManager avec les options spécifiées.

CreateDisplayDevice(DisplayAdapter)

Crée un objet DisplayDevice pour l’adaptateur donné. DisplayDevice peut être utilisé pour créer et présenter du contenu en plein écran aux cibles sur l’adaptateur donné.

CreateDisplayDeviceForIndirectAdapter(DisplayAdapter, DisplayAdapter)

Gère la propriété d’un ou plusieurs objets DisplayTarget et fournit des méthodes pour créer des objets DisplayState .

Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

GetCurrentAdapters()

Énumère l’ensemble des cartes graphiques actuellement présentes sur le système.

GetCurrentTargets()

Énumère l’ensemble des cibles d’affichage actuellement présentes sur le système.

ReleaseTarget(DisplayTarget)

Libère la propriété de la cible d’affichage spécifiée, ce qui permet à d’autres composants du système d’en acquérir la propriété.

Start()

Commence à écouter tous les événements DisplayManager de manière atomique. Les événements DisplayManager ne sont pas déclenchés tant que vous n’appelez pas Start.

Stop()

Cesse d’écouter tous les événements DisplayManager de façon atomique et déclenche désactivé de façon synchrone.

TryAcquireTarget(DisplayTarget)

Tente d’acquérir la propriété exclusive d’un DisplayTarget.

TryAcquireTargetsAndCreateEmptyState(IIterable<DisplayTarget>)

Tente d’acquérir la propriété exclusive d’une collection d’objets DisplayTarget et crée un objet DisplayState modifiable vide, qui prend en charge la connexion de chemins à ces cibles.

TryAcquireTargetsAndCreateSubstate(DisplayState, IIterable<DisplayTarget>)

Tente d’acquérir la propriété exclusive d’une collection d’objets DisplayTarget et extrait un sous-ensemble d’un DisplayState donné uniquement pour les cibles passées à cette méthode. L’état résultant peut être modifié et appliqué.

TryAcquireTargetsAndReadCurrentState(IIterable<DisplayTarget>)

Tente d’acquérir la propriété exclusive d’une collection d’objets DisplayTarget et crée un DisplayState modifiable rempli avec l’état actuel des cibles fournies.

TryReadCurrentStateForAllTargets()

Crée un objet DisplayState en lecture seule rempli avec l’état d’affichage du système entier pour toutes les cibles.

TryReadCurrentStateForModeQuery()

Gère la propriété d’un ou plusieurs objets DisplayTarget et fournit des méthodes pour créer des objets DisplayState .

Événements

Changed

Événement déclenché lorsque du matériel d’affichage système est ajouté, supprimé ou modifié. Cela peut se produire chaque fois que les collections DisplayAdapter ou DisplayTarget changent. Utilisez cet événement pour détecter ces modifications et appelez GetCurrentAdapters et/ou GetCurrentTargets pour obtenir les collections mises à jour.

Disabled

Événement déclenché chaque fois que la pile d’affichage de la session active est désactivée et que DisplayManager.Stop est appelé. Vous pouvez désactiver la pile d’affichage de session dans plusieurs cas, par exemple en cas de basculement de sessions Terminal Services ou pour récupérer en cas de défaillance de pilote. Nous recommandons aux abonnés d’essayer de propre lorsque Désactivé est appelé. La plupart des API d’affichage échouent lorsque la pile d’affichage de session est désactivée.

Enabled

Événement déclenché chaque fois que la pile d’affichage de la session active est activée et que DisplayManager.Start est appelé. Vous pouvez réactiver la pile d’affichage de session dans plusieurs cas, par exemple changer de session Terminal Services ou pour récupérer en cas de défaillance du pilote. Nous recommandons aux abonnés d’énumérer à nouveau toutes les cibles et l’état de cet appel, car la pile d’affichage système peut être laissée dans n’importe quel état avant que cet événement ne soit déclenché.

PathsFailedOrInvalidated

Événement déclenché chaque fois qu’un chemin d’affichage échoue ou est invalidé de manière asynchrone par le système. Cela peut être dû à l’évolution des besoins en bande passante matérielle ou à des défaillances de pilotes.

Les abonnés à cet événement doivent appeler TryAcquireTargetsAndReadCurrentState pour les cibles dont ils sont propriétaires et case activée si la propriété Status de l’un des chemins de l’objet DisplayState résultant a la valeur FailedAsync ou InvalidatedAsync, et d’effectuer l’action recommandée.

S’applique à