Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DeviceInformation.CreateWatcher(String) method

Applies to Windows and Windows Phone

Creates a DeviceWatcher for devices matching the specified Advanced Query Syntax (AQS) string.

Syntax


public static DeviceWatcher CreateWatcher(
  string aqsFilter
)

Parameters

aqsFilter

Type: System.String [.NET] | Platform::String [C++]

An AQS string that filters the DeviceInformation objects to enumerate. Typically this string is retrieved from the GetDeviceSelector method of a class that interacts with devices. For example, GetDeviceSelector retrieves the string for the StorageDevice class.

Return value

Type: DeviceWatcher

The created DeviceWatcher.

Remarks

The DeviceWatcher first performs an initial enumeration of devices, raising an Added event for each device that it finds, and raising an EnumerationCompleted event when the initial enumeration is complete. After the initial enumeration is complete, it raises events when a device is added, deleted, or updated.

Note  An app must subscribe to all of the added, removed, and updated events to be notified when there are device additions, removals or updates. If an app handles only the added event, it will not receive an update if a device is added to the system after the initial device enumeration completes.

See the DeviceWatcher class for an example.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Devices.Enumeration
Windows::Devices::Enumeration [C++]

Metadata

Windows.winmd

See also

DeviceInformation
CreateWatcher
CreateWatcher(DeviceClass)
CreateWatcher(String, IIterable_1)

 

 

Show:
© 2014 Microsoft. All rights reserved.