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

Applies to Windows and Windows Phone

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 the list of properties in How to retrieve additional properties for a device or PnP object.

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

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)
How to retrieve additional properties for a device or PnP object