DeviceWatcher Classe

Definição

Namespace:

Windows.Devices.Enumeration

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 DeviceWatcher

Public NotInheritable Class DeviceWatcher

Herança

Object Platform::Object IInspectable DeviceWatcher

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

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.

Confira também

• Exemplo de enumeração e emparelhamento de dispositivos