Skip to main content
PnpObject.CreateWatcher(PnpObjectType, IIterable(String), String) | createWatcher(PnpObjectType, IIterable(String), String) method

Returns a PnpObjectWatcher object that is used to enumerate a filtered collection of PnP objects using events.

Syntax


var pnpObjectWatcher = Windows.Devices.Enumeration.Pnp.PnpObject.createWatcher(type, requestedProperties, aqsFilter);

public static PnpObjectWatcher CreateWatcher(
  PnpObjectType type, 
  IEnumerable<string> requestedProperties, 
  string aqsFilter
)

Public Shared Function CreateWatcher(
  type As PnpObjectType,  
  requestedProperties As IEnumerable(Of String),  
  aqsFilter As String 
) As PnpObjectWatcher

public:
static PnpObjectWatcher^ CreateWatcher(
  PnpObjectType type, 
  IIterable<String^>^ requestedProperties, 
  String^ aqsFilter
)

Parameters

type

Type: PnpObjectType

The type of the PnpObject.

requestedProperties

Type: IIterable<String> [JavaScript/C++] | System.Collections.Generic.IEnumerable<String> [.NET]

An iterable list of additional properties to include in the Properties property of the PnpObject objects included in enumeration results. For more info on what the properties represent, see Device information properties.

aqsFilter

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

An AQS string that filters the PnP objects that will be returned. Typically, this string is retrieved from the GetDeviceSelector method of a class that interacts with devices.

Return value

Type: PnpObjectWatcher

A PnpObjectWatcher object used to enumerate the collection by registering event notification delegates and by issuing start and stop event notifications.

Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

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

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

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.Pnp
Windows::Devices::Enumeration::Pnp [C++]

Metadata

Windows.winmd

See also

PnpObject
CreateWatcher(PnpObjectType, IIterable_1)
Device information properties