Partilhar via


DeviceWatcher Classe

Definição

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

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 .

diagrama de estado dos estados devicewatcher

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.

Aplica-se a

Confira também