DeviceWatcher Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 DeviceWatcherPublic NotInheritable Class DeviceWatcher- Ereditarietà
- 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 .
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. |