DeviceWatcher Classe

Définition

Espace de noms:

Windows.Devices.Enumeration

Énumère les appareils de manière dynamique, afin que l’application reçoive des notifications si des appareils sont ajoutés, supprimés ou modifiés une fois l’énumération initiale terminée.

public ref class DeviceWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DeviceWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DeviceWatcher

Public NotInheritable Class DeviceWatcher

Héritage

Object Platform::Object IInspectable DeviceWatcher

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Pour obtenir des exemples complets en C# et C++, consultez l’exemple d’énumération et de jumelage d’appareils.

Remarques

Une application appelle Démarrer pour commencer la recherche d’appareils. Au cours de cette énumération initiale, DeviceWatcher déclenche un événement Added pour chaque appareil trouvé, jusqu’à ce que tous les appareils soient trouvés. DeviceWatcher déclenche un événement EnumerationCompleted lorsque l’énumération initiale est terminée et continue à déclencher des événements si un appareil est ajouté, mis à jour ou supprimé.

Le diagramme suivant montre comment DeviceWatcher passe entre les états représentés par l’énumération DeviceWatcherStatus .

La méthode Start ne peut être appelée que lorsque DeviceWatcher est à l’état Créé, Arrêté ou Abandonné . La propriété Status indique l’état DeviceWatcher. Lorsque vous relancez l’observateur, attendez l’événement Stopped avant d’appeler Start.

Stop effectue la transition de DeviceWatcher vers l’état d’arrêt et se termine immédiatement. L’observateur passe à l’état Arrêté une fois que tous les événements déjà déclenchés sont terminés.

Les applications peuvent attendre l’événement Stopped si elles ont besoin de savoir quand DeviceWatcher s’est arrêté. Les appelants doivent attendre l’événement Stopped avant de pouvoir appeler Start pour redémarrer l’observateur. Les appelants peuvent se désabonner des événements s’ils ne souhaitent pas recevoir d’événements supplémentaires après l’arrêt , mais ne veulent pas attendre l’événement Stopped .

Notes

Une application doit s’abonner à tous les événements ajoutés, supprimés et mis à jour pour être avertie en cas d’ajouts, de suppressions ou de mises à jour d’appareils. Si une application gère uniquement l’événement ajouté , elle ne reçoit pas de mise à jour si un appareil est ajouté au système une fois l’énumération initiale de l’appareil terminée.

Propriétés

Status

Status de DeviceWatcher.

Méthodes

GetBackgroundTrigger(IIterable<DeviceWatcherEventKind>)	Obtient un objet DeviceWatcherTrigger qui analyse les modifications apportées à la liste des appareils.
Start()	Démarre une recherche d’appareils et s’abonne aux événements d’énumération d’appareils.
Stop()	Arrêtez le déclenchement des événements qui ajoutent, mettent à jour et suppriment des résultats d’énumération.

Événements

Added	Événement déclenché lorsqu’un appareil est ajouté à la collection énumérée par DeviceWatcher.
EnumerationCompleted	Événement déclenché lorsque l’énumération des appareils est terminée.
Removed	Événement déclenché lorsqu’un appareil est supprimé de la collection d’appareils énumérés.
Stopped	Événement déclenché lorsque l’opération d’énumération a été arrêtée.
Updated	Événement déclenché lorsqu’un appareil est mis à jour dans la collection d’appareils énumérés.

Voir aussi

• Exemple d’énumération et de jumelage d’appareils