PnpObjectWatcher Classe

Définition

Espace de noms:

Windows.Devices.Enumeration.Pnp

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 PnpObjectWatcher

Public NotInheritable Class PnpObjectWatcher

Héritage

Object Platform::Object IInspectable PnpObjectWatcher

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)

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.