PnpObjectWatcher Clase

Definición

Espacio de nombres:

Windows.Devices.Enumeration.Pnp

Importante

Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp.

La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher.

Genera eventos para notificar al cliente que se ha agregado, actualizado o quitado un PnpObject de una colección enumerada de objetos de dispositivo Pnp de forma incremental y asincrónica.

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

Herencia

Object Platform::Object IInspectable PnpObjectWatcher

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Una aplicación llama a Start para iniciar la búsqueda de dispositivos. Durante esta enumeración inicial, PnpObjectWatcher genera un evento Added para cada dispositivo que se encuentra, hasta que se encuentran todos los dispositivos. PnpObjectWatcher genera un evento EnumerationCompleted cuando se completa la enumeración inicial y continúa generando eventos si se agrega, actualiza o quita un dispositivo.

En el diagrama siguiente se muestra cómo se realiza la transición de PnpObjectWatcher entre los estados representados por la enumeración DeviceWatcherStatus .

Solo se puede llamar al método Start cuando PnpObjectWatcher está en estado Creado, Detenido o Anulado . La propiedad Status indica el estado PnpObjectWatcher. Al volver a iniciar el monitor, espere al evento Stopped antes de llamar a Start.

Una llamada a Stop realiza la transición de PnpObjectWatcher al estado de detención y se completa inmediatamente. El monitor pasará al estado Detenido una vez que se hayan completado todos los eventos que ya están en el proceso de generarse.

Después de llamar a Stop, las aplicaciones pueden esperar al evento Stopped si necesitan saber cuándo se ha detenido PnpObjectWatcher. Los autores de llamadas deben esperar al evento Stopped para poder llamar a Start para reiniciar el monitor. Los autores de llamadas pueden cancelar la suscripción a eventos si no quieren recibir eventos adicionales después de Detener , pero no quieren esperar al evento Stopped .

Propiedades

Status

Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Estado asociado a la operación asincrónica.

Métodos

Start()

Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Comienza a generar los eventos para informar al cliente de que se ha agregado, actualizado o quitado un objeto PnpObject .

Stop()

Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Detiene la generación de eventos para informar al cliente de que se ha agregado, actualizado o quitado un objeto PnpObject .

Eventos

Added	Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Se produce cuando se agrega un PnpObject a la colección enumerada por PnpObjectWatcher.
EnumerationCompleted	Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Se produce cuando se ha completado la enumeración de objetos de dispositivo Pnp.
Removed	Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Se produce cuando PnpObject se quita de la colección enumerada por PnpObjectWatcher.
Stopped	Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Se produce cuando PnpObjectWatcher ha dejado de supervisar los cambios en la colección de objetos de dispositivo Pnp.
Updated	Importante Ya no se recomienda usar los tipos en el espacio de nombres Windows.Devices.Enumeration.Pnp . En su lugar, los tipos del espacio de nombres Windows.Devices.Enumeration implementan un superconjunto moderno y mejor mantenido de la funcionalidad de Windows.Devices.Enumeration.Pnp. La alternativa a PnpObjectType es la enumeración Windows.Devices.Enumeration.DeviceInformationKind , que puede pasar como parámetro a las API Windows.Devices.Enumeration . Por ejemplo, en lugar de usar PnpObjectType al crear un PnpObjectWatcher, use DeviceInformationKind al crear un DeviceWatcher. Se produce cuando se actualizan las propiedades de un PnpObject en la colección enumerada por PnpObjectWatcher .