PnpObjectWatcher 클래스

정의

네임스페이스:

Windows.Devices.Enumeration.Pnp

중요

더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다.

PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다.

PnpObject가 증분 및 비동기 방식으로 Pnp 디바이스 개체의 열거된 컬렉션에서 추가, 업데이트 또는 제거되었음을 클라이언트에 알리는 이벤트를 발생합니다.

public ref class PnpObjectWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PnpObjectWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PnpObjectWatcher

Public NotInheritable Class PnpObjectWatcher

상속

Object Platform::Object IInspectable PnpObjectWatcher

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

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

설명

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

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

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

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

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

속성

Status

중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. 비동기 작업과 연결된 상태.

메서드

Start()

중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. PnpObject가 추가, 업데이트 또는 제거되었음을 클라이언트에 알리기 위해 이벤트 발생을 시작합니다.

Stop()

중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. PnpObject가 추가, 업데이트 또는 제거되었음을 클라이언트에 알리기 위해 이벤트 발생을 중지합니다.

이벤트

Added	중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. PnpObjectWatcher가 열거한 컬렉션에 PnpObject를 추가할 때 발생합니다.
EnumerationCompleted	중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. Pnp 디바이스 개체의 열거가 완료되면 발생합니다.
Removed	중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. PnpObjectWatcher가 열거한 컬렉션에서 PnpObject를 제거할 때 발생합니다.
Stopped	중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. PnpObjectWatcher가 Pnp 디바이스 개체의 컬렉션에 대한 변경 내용 모니터링을 중지했을 때 발생합니다.
Updated	중요 더 이상 Windows.Devices.Enumeration.Pnp 네임스페이스의 형식을 사용하지 않는 것이 좋습니다. 대신 Windows.Devices.Enumeration 네임스페이스의 형식은 Windows.Devices.Enumeration.Pnp 기능의 최신 및 더 나은 유지 관리 상위 집합을 구현합니다. PnpObjectType의 대안은 Windows.Devices.Enumeration.DeviceInformationKind 열거형으로, Windows.Devices.Enumeration API에 매개 변수로 전달할 수 있습니다. 예를 들어 PnpObjectWatcher를 만들 때 PnpObjectType을 사용하는 대신 DeviceWatcher를 만들 때 DeviceInformationKind를 사용합니다. PnpObjectWatcher로 열거된 컬렉션의 PnpObject 속성이 업데이트될 때 발생합니다.