DeviceWatcher Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
É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 DeviceWatcherPublic NotInheritable Class DeviceWatcher- Héritage
- Attributs
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. |