PnpObjectWatcher Classe

Definizione

Spazio dei nomi:

Windows.Devices.Enumeration.Pnp

Importante

Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp.

L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher.

Genera eventi per notificare al client che un PnpObject è stato aggiunto, aggiornato o rimosso da una raccolta enumerata di oggetti dispositivo Pnp in modo incrementale e asincrono.

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

Ereditarietà

Object Platform::Object IInspectable PnpObjectWatcher

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Un'app chiama Start per avviare la ricerca dei dispositivi. Durante questa enumerazione iniziale, PnpObjectWatcher genera un evento Added per ogni dispositivo trovato, fino a quando non vengono trovati tutti i dispositivi. PnpObjectWatcher genera un evento EnumerationCompleted al termine dell'enumerazione iniziale e continua a generare eventi se un dispositivo viene aggiunto, aggiornato o rimosso.

Il diagramma seguente mostra come PnpObjectWatcher esegue la transizione tra gli stati rappresentati dall'enumerazione DeviceWatcherStatus .

Il metodo Start può essere chiamato solo quando PnpObjectWatcher si trova nello stato Created, Stopped o Aborted . La proprietà Status indica lo stato PnpObjectWatcher. Quando si avvia nuovamente il watcher, attendere l'evento Stopped prima di chiamare Start.

Una chiamata a Stop esegue la transizione di PnpObjectWatcher allo stato Arresto e viene completata immediatamente. Il watcher passerà allo stato Arrestato dopo il completamento di tutti gli eventi già in fase di generazione.

Dopo aver chiamato Stop, le app potrebbero attendere l'evento Stopped se devono sapere quando PnpObjectWatcher è stato arrestato. I chiamanti devono attendere l'evento Stopped prima di poter chiamare Start per riavviare il watcher. I chiamanti possono annullare la sottoscrizione agli eventi se non vogliono ricevere altri eventi dopo Stop , ma non vogliono attendere l'evento Stopped .

Proprietà

Status

Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Stato associato all'operazione asincrona.

Metodi

Start()

Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Avvia la generazione degli eventi per informare il client che un PnpObject è stato aggiunto, aggiornato o rimosso.

Stop()

Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Arresta la generazione degli eventi per informare il client che un PnpObject è stato aggiunto, aggiornato o rimosso.

Eventi

Added	Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Si verifica quando un PnpObject viene aggiunto all'insieme enumerato da PnpObjectWatcher.
EnumerationCompleted	Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Si verifica quando è stata completata l'enumerazione degli oggetti dispositivo Pnp.
Removed	Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Si verifica quando un PnpObject viene rimosso dalla raccolta enumerata da PnpObjectWatcher.
Stopped	Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Si verifica quando PnpObjectWatcher ha interrotto il monitoraggio delle modifiche apportate alla raccolta di oggetti dispositivo Pnp.
Updated	Importante Non è più consigliabile usare i tipi nello spazio dei nomi Windows.Devices.Enumeration.Pnp . I tipi nello spazio dei nomi Windows.Devices.Enumeration implementano invece un superset moderno e gestito meglio delle funzionalità di Windows.Devices.Enumeration.Pnp. L'alternativa a PnpObjectType è l'enumerazione Windows.Devices.Enumeration.DeviceInformationKind , che è possibile passare come parametro alle API Windows.Devices.Enumeration . Ad esempio, anziché usare PnpObjectType quando crei un PnpObjectWatcher, usa DeviceInformationKind quando crei un DeviceWatcher. Si verifica quando vengono aggiornate le proprietà di un PnpObject nell'insieme enumerato da PnpObjectWatcher .