DeviceWatcherStatus Enum

Definition

Describes the state of a DeviceWatcher object.

public enum class DeviceWatcherStatus
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class DeviceWatcherStatus
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum DeviceWatcherStatus
var value = Windows.Devices.Enumeration.DeviceWatcherStatus.created
Public Enum DeviceWatcherStatus
Inheritance
DeviceWatcherStatus
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Fields

Name Value Description
Created 0

This is the initial state of a Watcher object. During this state clients can register event handlers.

Started 1

The watcher transitions to the Started state once Start is called. The watcher is enumerating the initial collection. Note that during this enumeration phase it is possible to receive Updated and Removed notifications but only to items that have already been Added.

EnumerationCompleted 2

The watcher has completed enumerating the initial collection. Items can still be added, updated or removed from the collection.

Stopping 3

The client has called Stop and the watcher is still in the process of stopping. Events may still be raised.

Stopped 4

The client has called Stop and the watcher has completed all outstanding events. No further events will be raised.

Aborted 5

The watcher has aborted operation. No subsequent events will be raised.

Remarks

The following state diagram shows how the DeviceWatcher transitions between the states represented by DeviceWatcherStatus enumeration.

state diagram of DeviceWatcher states

Applies to