DeviceInformation.CreateWatcher 메서드

정의

네임스페이스:

Windows.Devices.Enumeration

오버로드

CreateWatcher()	모든 디바이스에 대한 DeviceWatcher 를 만듭니다.
CreateWatcher(String)	지정된 AQS(고급 쿼리 구문) 문자열과 일치하는 디바이스용 DeviceWatcher 를 만듭니다.
CreateWatcher(DeviceClass)	지정된 DeviceClass와 일치하는 디바이스에 대한 DeviceWatcher를 만듭니다.
CreateWatcher(String, IIterable<String>)	지정된 AQS(고급 쿼리 구문) 문자열 및 지정된 속성 컬렉션과 일치하는 디바이스에 대한 DeviceWatcher 를 만듭니다.
CreateWatcher(String, IIterable<String>, DeviceInformationKind)	지정된 AQS(고급 쿼리 구문) 문자열, 지정된 속성 컬렉션 및 디바이스 종류와 일치하는 디바이스에 대한 DeviceWatcher 를 만듭니다.

CreateWatcher()

모든 디바이스에 대한 DeviceWatcher 를 만듭니다.

public:
 static DeviceWatcher ^ CreateWatcher();

/// [Windows.Foundation.Metadata.Overload("CreateWatcher")]
 static DeviceWatcher CreateWatcher();

[Windows.Foundation.Metadata.Overload("CreateWatcher")]
public static DeviceWatcher CreateWatcher();

function createWatcher()

Public Shared Function CreateWatcher () As DeviceWatcher

반환

DeviceWatcher

만든 DeviceWatcher입니다.

특성

OverloadAttribute

설명

DeviceWatcher는 먼저 디바이스의 초기 열거를 수행하고, 디바이스가 찾은 각 디바이스에 대해 Added 이벤트를 발생시키고, 초기 열거가 완료되면 EnumerationCompleted 이벤트를 발생합니다. 초기 열거가 완료되면 디바이스가 추가, 삭제 또는 업데이트되면 이벤트가 발생합니다.

예제는 DeviceWatcher 클래스를 참조하세요.

참고

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

추가 정보

• CreateWatcher(DeviceClass)
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)

CreateWatcher(String)

지정된 AQS(고급 쿼리 구문) 문자열과 일치하는 디바이스용 DeviceWatcher 를 만듭니다.

public:
 static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter);

/// [Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilter")]
 static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter);

[Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilter")]
public static DeviceWatcher CreateWatcher(string aqsFilter);

function createWatcher(aqsFilter)

Public Shared Function CreateWatcher (aqsFilter As String) As DeviceWatcher

매개 변수

aqsFilter

String

Platform::String

winrt::hstring

열거할 DeviceInformation 개체를 필터링하는 AQS 문자열입니다. 일반적으로 이 문자열은 디바이스와 상호 작용하는 클래스의 GetDeviceSelector 메서드에서 검색됩니다. 예를 들어 GetDeviceSelector 는 StorageDevice 클래스에 대한 문자열을 검색합니다.

반환

DeviceWatcher

만든 DeviceWatcher입니다.

특성

OverloadAttribute

설명

참고

이 오버로드는 JavaScript에서 사용할 수 없습니다. JavaScript의 AQS 문자열에서 DeviceWatcher 를 만들려면 CreateWatcher(String, IIterable_1) 오버로드를 사용하고 두 번째 매개 변수로 전달 null 합니다.

DeviceWatcher는 먼저 디바이스의 초기 열거를 수행하고, 디바이스가 찾은 각 디바이스에 대해 Added 이벤트를 발생시키고, 초기 열거가 완료되면 EnumerationCompleted 이벤트를 발생합니다. 초기 열거가 완료되면 디바이스가 추가, 삭제 또는 업데이트되면 이벤트가 발생합니다.

참고

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

예제는 DeviceWatcher 클래스를 참조하세요.

추가 정보

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String, IIterable<String>)

CreateWatcher(DeviceClass)

지정된 DeviceClass와 일치하는 디바이스에 대한 DeviceWatcher를 만듭니다.

public:
 static DeviceWatcher ^ CreateWatcher(DeviceClass deviceClass);

/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("CreateWatcherDeviceClass")]
 static DeviceWatcher CreateWatcher(DeviceClass const& deviceClass);

[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("CreateWatcherDeviceClass")]
public static DeviceWatcher CreateWatcher(DeviceClass deviceClass);

function createWatcher(deviceClass)

Public Shared Function CreateWatcher (deviceClass As DeviceClass) As DeviceWatcher

매개 변수

deviceClass

DeviceClass

DeviceWatcher를 사용하여 열거할 디바이스 클래스입니다.

반환

DeviceWatcher

만든 DeviceWatcher입니다.

특성

DefaultOverloadAttribute OverloadAttribute

설명

DeviceWatcher는 먼저 디바이스의 초기 열거를 수행하고, 디바이스가 찾은 각 디바이스에 대해 Added 이벤트를 발생시키고, 초기 열거가 완료되면 EnumerationCompleted 이벤트를 발생합니다. 초기 열거가 완료되면 디바이스가 추가, 삭제 또는 업데이트되면 이벤트가 발생합니다.

참고

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

예제는 DeviceWatcher 클래스를 참조하세요.

추가 정보

• CreateWatcher()
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)

CreateWatcher(String, IIterable<String>)

지정된 AQS(고급 쿼리 구문) 문자열 및 지정된 속성 컬렉션과 일치하는 디바이스에 대한 DeviceWatcher 를 만듭니다.

public:
 static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties);

/// [Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilterAndAdditionalProperties")]
 static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties);

[Windows.Foundation.Metadata.Overload("CreateWatcherAqsFilterAndAdditionalProperties")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties);

function createWatcher(aqsFilter, additionalProperties)

Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String)) As DeviceWatcher

매개 변수

aqsFilter

String

Platform::String

winrt::hstring

열거할 DeviceInformation 개체를 필터링하는 AQS 문자열입니다. 일반적으로 이 문자열은 디바이스와 상호 작용하는 클래스의 GetDeviceSelector 메서드에서 검색됩니다. 예를 들어 GetDeviceSelector 는 StorageDevice 클래스에 대한 문자열을 검색합니다.

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

열거형 결과에서 DeviceInformation 개체의 Properties 속성에 포함할 추가 속성의 반복 가능한 목록입니다. 속성이 나타내는 항목에 대한 자세한 내용은 디바이스 정보 속성을 참조하세요.

반환

DeviceWatcher

만든 DeviceWatcher입니다.

특성

OverloadAttribute

설명

DeviceWatcher는 먼저 디바이스의 초기 열거를 수행하고, 디바이스가 찾은 각 디바이스에 대해 Added 이벤트를 발생시키고, 초기 열거가 완료되면 EnumerationCompleted 이벤트를 발생합니다. 초기 열거가 완료되면 디바이스가 추가, 삭제 또는 업데이트되면 이벤트가 발생합니다.

참고

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

예제는 DeviceWatcher 클래스를 참조하세요.

추가 정보

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String)

CreateWatcher(String, IIterable<String>, DeviceInformationKind)

지정된 AQS(고급 쿼리 구문) 문자열, 지정된 속성 컬렉션 및 디바이스 종류와 일치하는 디바이스에 대한 DeviceWatcher 를 만듭니다.

public:
 static DeviceWatcher ^ CreateWatcher(Platform::String ^ aqsFilter, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind);

/// [Windows.Foundation.Metadata.Overload("CreateWatcherWithKindAqsFilterAndAdditionalProperties")]
 static DeviceWatcher CreateWatcher(winrt::hstring const& aqsFilter, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind);

[Windows.Foundation.Metadata.Overload("CreateWatcherWithKindAqsFilterAndAdditionalProperties")]
public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties, DeviceInformationKind kind);

function createWatcher(aqsFilter, additionalProperties, kind)

Public Shared Function CreateWatcher (aqsFilter As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind) As DeviceWatcher

매개 변수

aqsFilter

String

Platform::String

winrt::hstring

열거할 DeviceInformation 개체를 필터링하는 AQS 문자열입니다. 일반적으로 이 문자열은 디바이스와 상호 작용하는 클래스의 GetDeviceSelector 메서드에서 검색됩니다. 예를 들어 GetDeviceSelector 는 StorageDevice 클래스에 대한 문자열을 검색합니다.

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

열거형 결과에서 DeviceInformation 개체의 Properties 속성에 포함할 추가 속성의 반복 가능한 목록입니다. 속성이 나타내는 항목에 대한 자세한 내용은 디바이스 정보 속성을 참조하세요.

kind

DeviceInformationKind

DeviceWatcher가 관심 있는 특정 유형의 디바이스입니다.

반환

DeviceWatcher

만든 DeviceWatcher입니다.

특성

OverloadAttribute

추가 정보

• CreateWatcher()
• CreateWatcher(DeviceClass)
• CreateWatcher(String)
• CreateWatcher(String, IIterable<String>)