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 Platform::Object IInspectable DeviceWatcher

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

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

예제

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

설명

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

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

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

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

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

참고

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

속성

Status

DeviceWatcher의 상태.

메서드

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

이벤트

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

추가 정보

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