PnpObjectWatcher 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.
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 PnpObjectWatcherPublic NotInheritable Class PnpObjectWatcher- 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)
|
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. |