DeviceWatcher Clase

Definición

Espacio de nombres:

Windows.Devices.Enumeration

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

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)

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 .

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.

Consulte también

• Ejemplo de emparejamiento y enumeración de dispositivos