DeviceWatcher Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Enumera dispositivos dinamicamente, para que o aplicativo receba notificações se os dispositivos forem adicionados, removidos ou alterados após a conclusão da enumeração inicial.
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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
Para obter exemplos completos em C# e C++, consulte o exemplo de enumeração e emparelhamento do dispositivo.
Comentários
Um aplicativo chama Iniciar para iniciar a pesquisa de dispositivos. Durante essa enumeração inicial, o DeviceWatcher gera um evento Adicionado para cada dispositivo encontrado, até que todos os dispositivos sejam encontrados. O DeviceWatcher gera um evento EnumerationCompleted quando a enumeração inicial é concluída e continua a gerar eventos se um dispositivo for adicionado, atualizado ou removido.
O diagrama a seguir mostra como o DeviceWatcher faz a transição entre os estados representados pela enumeração DeviceWatcherStatus .
O método Start só pode ser chamado quando o DeviceWatcher está no estado Criado, Parado ou Anulado . A propriedade Status indica o estado DeviceWatcher. Ao iniciar novamente o observador, aguarde o evento Parado antes de chamar Iniciar.
Stop faz a transição do DeviceWatcher para o estado De interrupção e é concluído imediatamente. O observador fará a transição para o estado Parado depois que todos os eventos que já estiverem em processo de geração forem concluídos.
Os aplicativos podem aguardar o evento Parado se precisarem saber quando o DeviceWatcher foi interrompido. Os chamadores devem aguardar o evento Parado antes de poderem chamar Iniciar para reiniciar o observador. Os chamadores poderão cancelar a assinatura de eventos se não quiserem receber eventos adicionais após Parar , mas não quiserem aguardar o evento Parado .
Observação
Um aplicativo deve assinar todos os eventos adicionados, removidos e atualizados para serem notificados quando houver adições, remoções ou atualizações do dispositivo. Se um aplicativo manipular apenas o evento adicionado , ele não receberá uma atualização se um dispositivo for adicionado ao sistema após a conclusão da enumeração inicial do dispositivo.
Propriedades
| Status |
O status do DeviceWatcher. |
Métodos
| GetBackgroundTrigger(IIterable<DeviceWatcherEventKind>) |
Obtém um monitoramento de objeto DeviceWatcherTrigger para alterações na lista de dispositivos. |
| Start() |
Inicia uma pesquisa por dispositivos e assina eventos de enumeração de dispositivo. |
| Stop() |
Pare de gerar os eventos que adicionam, atualizam e removem os resultados da enumeração. |
Eventos
| Added |
Evento gerado quando um dispositivo é adicionado à coleção enumerada pelo DeviceWatcher. |
| EnumerationCompleted |
Evento gerado quando a enumeração de dispositivos é concluída. |
| Removed |
Evento gerado quando um dispositivo é removido da coleção de dispositivos enumerados. |
| Stopped |
Evento gerado quando a operação de enumeração é interrompida. |
| Updated |
Evento gerado quando um dispositivo é atualizado na coleção de dispositivos enumerados. |