Compartir a través de


DeviceWatcher Clase

Definición

Enumera los dispositivos dinámicamente, de modo que la aplicación reciba notificaciones si se agregan, quitan o cambian los dispositivos una vez completada la enumeración 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
Herencia
Object Platform::Object IInspectable DeviceWatcher
Atributos

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)

Ejemplos

Para obtener ejemplos completos en C# y C++, consulte el ejemplo de emparejamiento y enumeración de dispositivos.

Comentarios

Una aplicación llama a Start para iniciar la búsqueda de dispositivos. Durante esta enumeración inicial, DeviceWatcher genera un evento Added para cada dispositivo que se encuentra, hasta que se encuentran todos los dispositivos. DeviceWatcher 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 realiza la transición deviceWatcher entre los estados representados por la enumeración DeviceWatcherStatus .

diagrama de estado de estados de DeviceWatcher

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

Detener realiza la transición de DeviceWatcher 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 proceso de generarse.

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

Nota

Una aplicación debe suscribirse a todos los eventos agregados, quitados y actualizados para recibir notificaciones cuando haya adiciones, eliminaciones o actualizaciones de dispositivos. Si una aplicación controla solo el evento agregado , no recibirá una actualización si se agrega un dispositivo al sistema una vez completada la enumeración inicial del dispositivo.

Propiedades

Status

Estado del DeviceWatcher.

Métodos

GetBackgroundTrigger(IIterable<DeviceWatcherEventKind>)

Obtiene una supervisión de objetos DeviceWatcherTrigger para los cambios en la lista de dispositivos.

Start()

Inicia una búsqueda de dispositivos y se suscribe a eventos de enumeración de dispositivos.

Stop()

Deje de generar los eventos que agregan, actualizan y quitan los resultados de enumeración.

Eventos

Added

Evento que se genera cuando se agrega un dispositivo a la colección enumerada por DeviceWatcher.

EnumerationCompleted

Evento que se genera cuando se completa la enumeración de dispositivos.

Removed

Evento que se genera cuando se quita un dispositivo de la colección de dispositivos enumerados.

Stopped

Evento que se genera cuando se ha detenido la operación de enumeración.

Updated

Evento que se genera cuando se actualiza un dispositivo en la colección de dispositivos enumerados.

Se aplica a

Consulte también