PnpObjectWatcher 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.
Important
Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp.
L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher.
Déclenche des événements pour informer le client qu’un PnpObject a été ajouté, mis à jour ou supprimé d’une collection énumérée d’objets d’appareil Pnp de manière incrémentielle et asynchrone.
public ref class PnpObjectWatcher sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PnpObjectWatcher final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PnpObjectWatcherPublic NotInheritable Class PnpObjectWatcher- 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)
|
Remarques
Une application appelle Démarrer pour commencer la recherche d’appareils. Au cours de cette énumération initiale, le PnpObjectWatcher déclenche un événement Added pour chaque appareil trouvé, jusqu’à ce que tous les appareils soient trouvés. Le PnpObjectWatcher 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 PnpObjectWatcher passe entre les états représentés par l’énumération DeviceWatcherStatus .
La méthode Start ne peut être appelée que lorsque le PnpObjectWatcher est à l’état Créé, Arrêté ou Abandonné . La propriété Status indique l’état PnpObjectWatcher. Lorsque vous relancez l’observateur, attendez l’événement Stopped avant d’appeler Start.
Un appel à Stop fait passer le PnpObjectWatcher à 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.
Après avoir appelé Stop, les applications peuvent attendre l’événement Stopped si elles ont besoin de savoir quand le PnpObjectWatcher 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 .
Propriétés
| Status |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Le status associé à l’opération asynchrone. |
Méthodes
| Start() |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Commence à déclencher les événements pour informer le client qu’un PnpObject a été ajouté, mis à jour ou supprimé. |
| Stop() |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Cesse de déclencher les événements pour informer le client qu’un PnpObject a été ajouté, mis à jour ou supprimé. |
Événements
| Added |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Se produit lorsqu’un PnpObject est ajouté à la collection énumérée par le PnpObjectWatcher. |
| EnumerationCompleted |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Se produit lorsque l’énumération des objets d’appareil Pnp a été terminée. |
| Removed |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Se produit lorsqu’un PnpObject est supprimé de la collection énumérée par le PnpObjectWatcher. |
| Stopped |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Se produit lorsque le PnpObjectWatcher a cessé de surveiller les modifications apportées à la collection d’objets d’appareil Pnp. |
| Updated |
Important Nous vous déconseillons d’utiliser les types dans l’espace de noms Windows.Devices.Enumeration.Pnp . Au lieu de cela, les types de l’espace de noms Windows.Devices.Enumeration implémentent un sur-ensemble moderne et mieux géré des fonctionnalités de Windows.Devices.Enumeration.Pnp. L’alternative à PnpObjectType est l’énumération Windows.Devices.Enumeration.DeviceInformationKind , que vous pouvez passer en tant que paramètre aux API Windows.Devices.Enumeration . Par exemple, au lieu d’utiliser PnpObjectType lorsque vous créez un PnpObjectWatcher, utilisez DeviceInformationKind lorsque vous créez un DeviceWatcher. Se produit lorsque les propriétés d’un PnpObject dans la collection énumérée par le PnpObjectWatcher sont mises à jour. |