Condividi tramite


DeviceWatcher Classe

Definizione

Enumera i dispositivi in modo dinamico, in modo che l'app riceva notifiche se i dispositivi vengono aggiunti, rimossi o modificati dopo il completamento dell'enumerazione iniziale.

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
Ereditarietà
Object Platform::Object IInspectable DeviceWatcher
Attributi

Requisiti Windows

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

Esempio

Per esempi completi in C# e C++, vedere l'esempio di enumerazione e associazione dei dispositivi.

Commenti

Un'app chiama Start per avviare la ricerca dei dispositivi. Durante questa enumerazione iniziale, DeviceWatcher genera un evento Added per ogni dispositivo trovato, fino a quando non vengono trovati tutti i dispositivi. DeviceWatcher 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 DeviceWatcher esegue la transizione tra gli stati rappresentati dall'enumerazione DeviceWatcherStatus .

Diagramma dello stato degli stati di DeviceWatcher

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

Arresta la transizione di DeviceWatcher 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.

Le app potrebbero attendere l'evento Stopped se devono sapere quando DeviceWatcher è 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 .

Nota

Un'app deve sottoscrivere tutti gli eventi aggiunti, rimossi e aggiornati per ricevere una notifica quando sono presenti aggiunte, rimozioni o aggiornamenti dei dispositivi. Se un'app gestisce solo l'evento aggiunto , non riceverà un aggiornamento se un dispositivo viene aggiunto al sistema dopo il completamento dell'enumerazione iniziale del dispositivo.

Proprietà

Status

Stato di DeviceWatcher.

Metodi

GetBackgroundTrigger(IIterable<DeviceWatcherEventKind>)

Ottiene un monitoraggio degli oggetti DeviceWatcherTrigger per le modifiche apportate all'elenco di dispositivi.

Start()

Avvia una ricerca dei dispositivi e sottoscrive gli eventi di enumerazione del dispositivo.

Stop()

Interrompere la generazione degli eventi che aggiungono, aggiornano e rimuovono i risultati dell'enumerazione.

Eventi

Added

Evento generato quando un dispositivo viene aggiunto alla raccolta enumerata da DeviceWatcher.

EnumerationCompleted

Evento generato al termine dell'enumerazione dei dispositivi.

Removed

Evento generato quando un dispositivo viene rimosso dalla raccolta di dispositivi enumerati.

Stopped

Evento generato quando l'operazione di enumerazione è stata arrestata.

Updated

Evento generato quando un dispositivo viene aggiornato nella raccolta di dispositivi enumerati.

Si applica a

Vedi anche