DeviceWatcher 클래스

정의

네임스페이스:

Windows.Devices.Enumeration

디바이스를 동적으로 열거하여 초기 열거가 완료된 후 디바이스가 추가, 제거 또는 변경된 경우 앱이 알림을 받도록 합니다.

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

상속

Object IInspectable DeviceWatcher

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

C# 및 C++의 전체 예제는 디바이스 열거 및 페어링 샘플을 참조하세요.

설명

앱이 호출 Start 하여 디바이스 검색을 시작합니다. 이 초기 열거형 동안 DeviceWatcher는 모든 디바이스를 찾을 때까지 발견된 각 디바이스에 대한 이벤트를 발생 Added 합니다. DeviceWatcher는 초기 열거가 완료되면 이벤트를 발생 EnumerationCompleted 시키고 디바이스가 추가, 업데이트 또는 제거된 경우 이벤트를 계속 발생합니다.

다음 다이어그램에서는 DeviceWatcher가 열거형으로 DeviceWatcherStatus 표시되는 상태 간에 전환하는 방법을 보여 줍니다.

DeviceWatcher Start 가 Created, Stopped 또는 Aborted 상태인 경우에만 메서드를 호출할 수 있습니다. 이 속성은 Status DeviceWatcher 상태를 나타냅니다. 감시자를 다시 시작할 때 호출Start하기 전에 이벤트를 기다립니다Stopped.

Stop 는 DeviceWatcher를 중지 상태로 전환하고 즉시 완료합니다. 이미 발생 중인 모든 이벤트가 완료되면 감시자가 중지 됨 상태로 전환됩니다.

앱은 DeviceWatcher가 Stopped 중지된 시기를 알아야 하는 경우 이벤트를 대기할 수 있습니다. 호출자는 감시자를 다시 시작하기 위해 Stopped 호출 Start 하기 전에 이벤트를 기다려야 합니다. 호출자는 이후에 추가 이벤트를 수신하지 않고 이벤트를 기다리 Stopped 지 않으려는 경우 이벤트에서 Stop 구독을 취소할 수 있습니다.

참고

앱은 디바이스 추가, 제거 또는 업데이트가 있을 때 알림을 받을 모든 addedremoved이벤트 및 updated 이벤트를 구독해야 합니다. 앱이 이벤트만 added 처리하는 경우 초기 디바이스 열거가 완료된 후 디바이스가 시스템에 추가되면 업데이트가 수신되지 않습니다.

속성

Status

의 DeviceWatcher상태입니다.

메서드

GetBackgroundTrigger(IIterable<DeviceWatcherEventKind>)	DeviceWatcherTrigger 디바이스 목록의 변경 내용에 대한 개체 모니터링을 가져옵니다.
Start()	디바이스 검색을 시작하고 디바이스 열거 이벤트를 구독합니다.
Stop()	열거형 결과를 추가, 업데이트 및 제거하는 이벤트 발생을 중지합니다.

이벤트

Added	디바이스가 열거 DeviceWatcher된 컬렉션에 추가될 때 발생하는 이벤트입니다.
EnumerationCompleted	디바이스 열거가 완료될 때 발생하는 이벤트입니다.
Removed	열거된 디바이스의 컬렉션에서 디바이스가 제거될 때 발생하는 이벤트입니다.
Stopped	열거형 작업이 중지될 때 발생하는 이벤트입니다.
Updated	열거된 디바이스의 컬렉션에서 디바이스가 업데이트될 때 발생하는 이벤트입니다.

추가 정보

• 디바이스 열거 및 페어링 샘플