PnpObjectWatcher Classe

Definição

Namespace:

Windows.Devices.Enumeration.Pnp

Importante

Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp.

A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher.

Gera eventos para notificar o cliente de que um PnpObject foi adicionado, atualizado ou removido de uma coleção enumerada de objetos de dispositivo Pnp de maneira incremental e assíncrona.

public ref class PnpObjectWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PnpObjectWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PnpObjectWatcher

Public NotInheritable Class PnpObjectWatcher

Herança

Object Platform::Object IInspectable PnpObjectWatcher

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)

Comentários

Um aplicativo chama Iniciar para iniciar a pesquisa de dispositivos. Durante essa enumeração inicial, o PnpObjectWatcher gera um evento Added para cada dispositivo encontrado, até que todos os dispositivos sejam encontrados. O PnpObjectWatcher 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 PnpObjectWatcher faz a transição entre os estados representados pela enumeração DeviceWatcherStatus .

O método Start só pode ser chamado quando o PnpObjectWatcher está no estado Criado, Parado ou Anulado . A propriedade Status indica o estado PnpObjectWatcher. Ao reiniciar o observador, aguarde o evento Parado antes de chamar Iniciar.

Uma chamada para Parar faz a transição do PnpObjectWatcher para o estado Parar e é concluída imediatamente. O observador fará a transição para o estado Parado depois que todos os eventos que já estão no processo de geração forem concluídos.

Depois de chamar Parar, os aplicativos poderão aguardar o evento Stopped se precisarem saber quando o PnpObjectWatcher 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 .

Propriedades

Status

Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. O status associado à operação assíncrona.

Métodos

Start()

Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. Começa a gerar os eventos para informar ao cliente que um PnpObject foi adicionado, atualizado ou removido.

Stop()

Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. Para de gerar os eventos para informar ao cliente que um PnpObject foi adicionado, atualizado ou removido.

Eventos

Added	Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. Ocorre quando um PnpObject é adicionado à coleção enumerada pelo PnpObjectWatcher.
EnumerationCompleted	Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. Ocorre quando a enumeração de objetos de dispositivo Pnp foi concluída.
Removed	Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. Ocorre quando um PnpObject é removido da coleção enumerada pelo PnpObjectWatcher.
Stopped	Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. Ocorre quando o PnpObjectWatcher parou de monitorar alterações na coleção de objetos de dispositivo Pnp.
Updated	Importante Não recomendamos mais que você use os tipos no namespace Windows.Devices.Enumeration.Pnp . Em vez disso, os tipos no namespace Windows.Devices.Enumeration implementam um superconjunto moderno e mais bem mantido da funcionalidade de Windows.Devices.Enumeration.Pnp. A alternativa a PnpObjectType é a enumeração Windows.Devices.Enumeration.DeviceInformationKind , que você pode passar como um parâmetro para APIs Windows.Devices.Enumeration . Por exemplo, em vez de usar PnpObjectType ao criar um PnpObjectWatcher, use DeviceInformationKind ao criar um DeviceWatcher. Ocorre quando as propriedades de um PnpObject na coleção enumerada pelo PnpObjectWatcher são atualizadas.