DeviceInformation
DeviceInformation
DeviceInformation
DeviceInformation
Class
Definition
Represents a device. This class allows access to well-known device properties as well as additional properties specified during device enumeration.
public : sealed class DeviceInformation : IDeviceInformation, IDeviceInformation2public sealed class DeviceInformation : IDeviceInformation, IDeviceInformation2Public NotInheritable Class DeviceInformation Implements IDeviceInformation, IDeviceInformation2// You can use this class in JavaScript.
- Attributes
| Device family |
Windows 10 (introduced v10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced v1)
|
Examples
This example incrementally enumerates devices, adding them to a list each time a device is found, and also handling removals and updates.
var watcher;
var isEnumerationComplete = false;
var deviceArray = new Array(); // Saves the enumeration results
function WatchDevices() {
try {
output.innerHTML = ""; // clear output field
watcher =
Windows.Devices.Enumeration.DeviceInformation.createWatcher();
// Add event handlers
watcher.addEventListener("added", onAdded);
watcher.addEventListener("removed", onRemoved);
watcher.addEventListener("updated", onUpdated);
watcher.addEventListener("enumerationcompleted",
onEnumerationCompleted);
watcher.addEventListener("stopped", onStopped);
// Start enumerating and listening for events
watcher.start();
} catch (e) {
document.getElementById("statusMessage").innerHTML =
"Failed to create watcher, error: " + e.message;
}
}
function stopWatcher() {
try {
watcher.stop();
}
catch (e) {
document.getElementById("statusMessage").innerHTML =
"Failed to stop watcher: " + e.message;
}
}
function onAdded(devinfo) {
document.getElementById("output").innerHTML += "<p>Device added: " +
devinfo.name + "</p>";
deviceArray.push(devinfo);
if (isEnumerationComplete) {
output.innerHTML = ""; // clear output field
printDeviceArray(document.getElementById("output"));
}
}
function onUpdated(devUpdate) {
document.getElementById("output").innerHTML += "<p>Device updated.</p>";
for (var i = 0; i < deviceArray.length; i++) {
if (deviceArray[i].id == devUpdate.id) {
deviceArray[i].update(devUpdate);
}
}
output.innerHTML = ""; // clear output field
printDeviceArray(document.getElementById("output"));
}
function onRemoved(devupdate) {
document.getElementById("output").innerHTML += "<p>Device removed.</p>";
for (var i = 0; i < deviceArray.length; i++) {
if (deviceArray[i].id == devupdate.id) {
deviceArray[i].slice(devupdate);
}
}
output.innerHTML = ""; // clear output field
printDeviceArray(document.getElementById("output"));
}
function onEnumerationCompleted(obj) {
isEnumerationComplete = true;
document.getElementById("output").innerHTML +=
"<p>Enumeration Completed.</p>";
printDeviceArray(document.getElementById("output"));
}
function onStopped(obj) {
document.getElementById("output").innerHTML += "<p>Stopped.</p>";
if (watcher.status == Windows.Devices.Enumeration.DeviceWatcherStatus.aborted) {
document.getElementById("output").innerHTML +=
"<p>Enumeration stopped unexpectedly. </p>";
document.getElementById("output").innerHTML +=
"<p>Click the Watch button to restart enumeration.</p>";
} else if (watcher.status == Windows.Devices.Enumeration.DeviceWatcherStatus.stopped) {
document.getElementById("output").innerHTML +=
"<p>You requested to stop enumeration. </p>";
document.getElementById("output").innerHTML +=
"<p>Click the Watch button to restart enumeration.</p>";
}
}
// Prints the friendly name of the device interface,
// its ID (device interface path), and whether it is enabled.
function printDevice(deviceInterface, outputDestination) {
outputDestination.innerHTML += "<p>Name: " +
deviceInterface.name + "<p/>";
outputDestination.innerHTML += "<p>Interface ID: " +
deviceInterface.id + "<p/>";
outputDestination.innerHTML += "<p>Enabled: " +
deviceInterface.isEnabled + "<p/>";
outputDestination.innerHTML += "<br />";
}
function printDeviceArray(outputDestination) {
for (var i = 0; i < deviceArray.length; i++) {
printDevice(deviceArray[i], outputDestination);
}
}
using System;
using System.Threading.Tasks;
using System.Collections.Generic;
using System.IO;
using System.Diagnostics;
using System.Linq;
using System.Text;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Windows.UI.Xaml.Media.Imaging;
using Windows.Devices.Enumeration;
using Windows.Devices.Enumeration.Pnp;
// The Blank Page item template is documented at http://go.microsoft.com/fwlink/?LinkId=234238
namespace Application1
{
/// <summary>
/// An empty page that can be used on its own or navigated to within a Frame.
/// </summary>
///
public sealed partial class BlankPage : Page
{
public BlankPage()
{
this.InitializeComponent();
}
Windows.UI.Core.CoreDispatcher dispatcher;
public static DeviceWatcher watcher = null;
public static int count = 0;
public static DeviceInformation[] interfaces = new DeviceInformation[1000];
public static bool isEnumerationComplete = false;
public static string StopStatus = null;
async void WatchDevices(object sender, RoutedEventArgs eventArgs)
{
try
{
dispatcher = Window.Current.CoreWindow.Dispatcher;
watcher = DeviceInformation.CreateWatcher();
// Add event handlers
watcher.Added += watcher_Added;
watcher.Removed += watcher_Removed;
watcher.Updated += watcher_Updated;
watcher.EnumerationCompleted += watcher_EnumerationCompleted;
watcher.Stopped += watcher_Stopped;
watcher.Start();
OutputText.Text = "Enumeration started.";
}
catch (ArgumentException)
{
//The ArgumentException gets thrown by FindAllAsync when the GUID isn't formatted properly
//The only reason we're catching it here is because the user is allowed to enter GUIDs without validation
//In normal usage of the API, this exception handling probably wouldn't be necessary when using known-good GUIDs
OutputText.Text = "Caught ArgumentException. Failed to create watcher.";
}
}
async void StopWatcher(object sender, RoutedEventArgs eventArgs)
{
try
{
if (watcher.Status == Windows.Devices.Enumeration.DeviceWatcherStatus.Stopped)
{
StopStatus = "The enumeration is already stopped.";
}
else
{
watcher.Stop();
}
}
catch (ArgumentException)
{
OutputText.Text = "Caught ArgumentException. Failed to stop watcher.";
}
}
async void watcher_Added(DeviceWatcher sender, DeviceInformation deviceInterface)
{
interfaces[count] = deviceInterface;
count += 1;
if (isEnumerationComplete)
{
await dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
DisplayDeviceInterfaceArray();
});
}
}
async void watcher_Updated(DeviceWatcher sender, DeviceInformationUpdate devUpdate)
{
int count2 = 0;
foreach (DeviceInformation deviceInterface in interfaces)
{
if (count2 < count)
{
if (interfaces[count2].Id == devUpdate.Id)
{
//Update the element.
interfaces[count2].Update(devUpdate);
}
}
count2 += 1;
}
await dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
OutputText.Text = "Enumeration updated. ";
DisplayDeviceInterfaceArray();
});
}
async void watcher_Removed(DeviceWatcher sender, DeviceInformationUpdate devUpdate)
{
int count2 = 0;
//Convert interfaces array to a list (IList).
List<DeviceInformation> interfaceList = new List<DeviceInformation>(interfaces);
foreach (DeviceInformation deviceInterface in interfaces)
{
if (count2 < count)
{
if (interfaces[count2].Id == devUpdate.Id)
{
//Remove the element.
interfaceList.RemoveAt(count2);
}
}
count2 += 1;
}
//Convert the list back to the interfaces array.
interfaces = interfaceList.ToArray();
count -= 1;
await dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
OutputText.Text = "Enumeration device was removed. ";
DisplayDeviceInterfaceArray();
});
}
async void watcher_EnumerationCompleted(DeviceWatcher sender, object args)
{
isEnumerationComplete = true;
await dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
OutputText.Text = "Enumeration complete. ";
DisplayDeviceInterfaceArray();
});
}
async void watcher_Stopped(DeviceWatcher sender, object args)
{
if (watcher.Status == Windows.Devices.Enumeration.DeviceWatcherStatus.Aborted)
{
StopStatus = "Enumeration stopped unexpectedly. Click Watch to restart enumeration.";
}
else if (watcher.Status == Windows.Devices.Enumeration.DeviceWatcherStatus.Stopped)
{
StopStatus = "You requested to stop the enumeration. Click Watch to restart enumeration.";
}
}
async void DisplayDeviceInterfaceArray()
{
DeviceInterfacesOutputList.Items.Clear();
int count2 = 0;
foreach (DeviceInformation deviceInterface in interfaces)
{
if (count2 < count)
{
DisplayDeviceInterface(deviceInterface);
}
count2 += 1;
}
}
async void DisplayDeviceInterface(DeviceInformation deviceInterface)
{
var id = "Id:" + deviceInterface.Id;
var name = deviceInterface.Name;
var isEnabled = "IsEnabled:" + deviceInterface.IsEnabled;
var item = id + " is \n" + name + " and \n" + isEnabled;
DeviceInterfacesOutputList.Items.Add(item);
}
}
}
Remarks
A DeviceInformation object is composed of an identity (DeviceInformation.Id ), a kind (DeviceInformation.Kind ), and a property bag (DeviceInformation.Properties ). All of the other properties of a DeviceInformation object are derived from the Properties property bag. For example, Name is derived from System.ItemNameDisplay.
Successful completion of FindAllAsync results in a DeviceInformationCollection containing DeviceInformation objects.
If a call to CreateWatcher succeeds, a DeviceInformation object is passed to the added event for each device that is found.
The Name property should only be used for display purposes only and not for finding a device because the Name can change due to localization or a user assigning a name.
CreateFromIdAsync creates a DeviceInformation object if successful.
The DeviceInformation class provides device information, but more specifically, it provides properties of the device interface, the interface that represents functionality that the device exposes. Multi-function devices may have more than one device interface. The physical object that a user sees as a device, is known as the device container, and has properties such as Manufacturer and ModelID. For more information about enumerating devices and recovering properties, see Enumerate devices.
Properties
EnclosureLocation EnclosureLocation EnclosureLocation EnclosureLocation
The physical location of the device in its enclosure. For example, it may describe the location of a webcam inside a laptop.
public : EnclosureLocation EnclosureLocation { get; }public EnclosureLocation EnclosureLocation { get; }Public ReadOnly Property EnclosureLocation As EnclosureLocation// You can use this property in JavaScript.
The object that describes the physical location of the device.
Remarks
If no enclosure location information is available, the property will be null.
Id Id Id Id
A string representing the identity of the device.
public : PlatForm::String Id { get; }public string Id { get; }Public ReadOnly Property Id As string// You can use this property in JavaScript.
- Value
- PlatForm::String string string string
A string representing the identity of the device.
Remarks
This ID can be used to activate device functionality using the CreateFromIdAsync methods on classes that implement device functionality.
The DeviceInformation object that the Id property identifies is actually a device interface . For simplicity in this documentation, the DeviceInformation object is called a device, and the identifier in its Id property is called a DeviceInformation ID.
IsDefault IsDefault IsDefault IsDefault
Indicates whether this device is the default device for the class.
public : PlatForm::Boolean IsDefault { get; }public bool IsDefault { get; }Public ReadOnly Property IsDefault As bool// You can use this property in JavaScript.
- Value
- PlatForm::Boolean bool bool bool
Indicates whether this device is the default device for the class.
IsEnabled IsEnabled IsEnabled IsEnabled
Indicates whether this device is enabled.
public : PlatForm::Boolean IsEnabled { get; }public bool IsEnabled { get; }Public ReadOnly Property IsEnabled As bool// You can use this property in JavaScript.
- Value
- PlatForm::Boolean bool bool bool
Indicates whether this device is enabled.
Kind Kind Kind Kind
Gets the type of DeviceInformation represented by this object.
public : DeviceInformationKind Kind { get; }public DeviceInformationKind Kind { get; }Public ReadOnly Property Kind As DeviceInformationKind// You can use this property in JavaScript.
The type of information represented by this object.
Name Name Name Name
The name of the device. This name is in the best available language for the app.
public : PlatForm::String Name { get; }public string Name { get; }Public ReadOnly Property Name As string// You can use this property in JavaScript.
- Value
- PlatForm::String string string string
The name of the device. This name is in the best available language for the app.
Remarks
The Name property should only be used for display purposes only and not for finding a device because the Name can change due to localization or a user assigning a name.
Pairing Pairing Pairing Pairing
Gets the information about the capabilities for this device to pair.
public : DeviceInformationPairing Pairing { get; }public DeviceInformationPairing Pairing { get; }Public ReadOnly Property Pairing As DeviceInformationPairing// You can use this property in JavaScript.
- Value
- DeviceInformationPairing DeviceInformationPairing DeviceInformationPairing DeviceInformationPairing
The pairing information for this device.
Properties Properties Properties Properties
Property store containing well-known values as well as additional properties that can be specified during device enumeration.
public : IMapView<string, object> Properties { get; }public IReadOnlyDictionary<string, object> Properties { get; }Public ReadOnly Property Properties As IReadOnlyDictionary<string, object>// You can use this property in JavaScript.
- Value
- IMapView<PlatForm::String, PlatForm::Object> IReadOnlyDictionary<string, object> IReadOnlyDictionary<string, object> IReadOnlyDictionary<string, object>
The property store for the device.
Remarks
For more info on what the properties represent, see Device information properties.
- See Also
Methods
CreateFromIdAsync(String) CreateFromIdAsync(String) CreateFromIdAsync(String) CreateFromIdAsync(String)
Creates a DeviceInformation object from a DeviceInformation ID.
public : static IAsyncOperation<DeviceInformation> CreateFromIdAsync(PlatForm::String deviceId)public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(String deviceId)Public Static Function CreateFromIdAsync(deviceId As String) As IAsyncOperation( Of DeviceInformation )// You can use this method in JavaScript.
- deviceId
- PlatForm::String String String String
The device ID.
An object for starting and managing the asynchronous creation of the DeviceInformation object.
Examples
The savedId variable in this example is a DeviceInformation ID previously saved by the application, obtained from the id property of the last-used DeviceInformation object.
// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId).then(
function(devinfo) {
// Use the created DeviceInformation object
printMessage("Created DeviceInformation. Name: " + devinfo.name);
},
function (e) {
displayError("Failed to create DeviceInformation: " + e.message);
});
- See Also
CreateFromIdAsync(String, IIterable)
CreateFromIdAsync(String, IIterable)
CreateFromIdAsync(String, IIterable)
CreateFromIdAsync(String, IIterable)
Creates a DeviceInformation object from a DeviceInformation ID and a list of additional properties.
public : static IAsyncOperation<DeviceInformation> CreateFromIdAsync(PlatForm::String deviceId, IIterable<PlatForm::String> additionalProperties)public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(String deviceId, IEnumerable<String> additionalProperties)Public Static Function CreateFromIdAsync(deviceId As String, additionalProperties As IEnumerable<String>) As IAsyncOperation( Of DeviceInformation )// You can use this method in JavaScript.
- deviceId
- PlatForm::String String String String
A string containing the DeviceInformation ID.
- additionalProperties
- IIterable<PlatForm::String> IEnumerable<String> IEnumerable<String> IEnumerable<String>
An iterable list of additional properties to include in the Properties property of the DeviceInformation objects in the enumeration results. For more info on what the properties represent, see Device information properties.
An object for starting and managing the asynchronous creation of the DeviceInformation object.
Examples
The following example builds a list of properties to include in the DeviceInformation object to create from a DeviceInformation ID.The savedId variable in this example is a DeviceInformation ID previously saved by the application, obtained from the id property of the last-used DeviceInformation object.
// Create a set of two additional properties
var propertiesToRetrieve = new Array();
propertiesToRetrieve.push("System.InterfaceClassGuid");
propertiesToRetrieve.push("System.Storage.IsPortable");
// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId, propertiesToRetrieve).then(
function(devinfo) {
// Use the created DeviceInformation object
printMessage("Created DeviceInformation. Name: " + devinfo.name);
},
function (e) {
displayError("Failed to create DeviceInformation: " + e.message);
});
- See Also
CreateFromIdAsync(String, IIterable, DeviceInformationKind)
CreateFromIdAsync(String, IIterable, DeviceInformationKind)
CreateFromIdAsync(String, IIterable, DeviceInformationKind)
CreateFromIdAsync(String, IIterable, DeviceInformationKind)
Creates a DeviceInformation object from a DeviceInformation ID, a list of additional properties, and a DeviceInformationKind parameter.
public : static IAsyncOperation<DeviceInformation> CreateFromIdAsync(PlatForm::String deviceId, IIterable<PlatForm::String> additionalProperties, DeviceInformationKind kind)public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(String deviceId, IEnumerable<String> additionalProperties, DeviceInformationKind kind)Public Static Function CreateFromIdAsync(deviceId As String, additionalProperties As IEnumerable<String>, kind As DeviceInformationKind) As IAsyncOperation( Of DeviceInformation )// You can use this method in JavaScript.
- deviceId
- PlatForm::String String String String
A string containing the DeviceInformation ID.
- additionalProperties
- IIterable<PlatForm::String> IEnumerable<String> IEnumerable<String> IEnumerable<String>
An iterable list of additional properties to include in the Properties property of the DeviceInformation objects in the enumeration results. For more info on what the properties represent, see Device information properties.
The type of DeviceInformation object you want to create.
An object for starting and managing the asynchronous creation of the DeviceInformation object.
- See Also
CreateWatcher() CreateWatcher() CreateWatcher() CreateWatcher()
Creates a DeviceWatcher for all devices.
public : static DeviceWatcher CreateWatcher()public static DeviceWatcher CreateWatcher()Public Static Function CreateWatcher() As DeviceWatcher// You can use this method in JavaScript.
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.
See the DeviceWatcher class for an example.
CreateWatcher(String) CreateWatcher(String) CreateWatcher(String) CreateWatcher(String)
Creates a DeviceWatcher for devices matching the specified Advanced Query Syntax (AQS) string.
public : static DeviceWatcher CreateWatcher(PlatForm::String aqsFilter)public static DeviceWatcher CreateWatcher(String aqsFilter)Public Static Function CreateWatcher(aqsFilter As String) As DeviceWatcher// You can use this method in JavaScript.
- aqsFilter
- PlatForm::String String String String
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.
The created DeviceWatcher.
Remarks
Note
This overload is not available from JavaScript. To create a DeviceWatcher from an AQS string in JavaScript, use the CreateWatcher(String, IIterable_1) overload and pass null as the second parameter.
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.
CreateWatcher(String, IIterable)
CreateWatcher(String, IIterable)
CreateWatcher(String, IIterable)
CreateWatcher(String, IIterable)
Creates a DeviceWatcher for devices matching the specified Advanced Query Syntax (AQS) string and the specified collection of properties.
public : static DeviceWatcher CreateWatcher(PlatForm::String aqsFilter, IIterable<PlatForm::String> additionalProperties)public static DeviceWatcher CreateWatcher(String aqsFilter, IEnumerable<String> additionalProperties)Public Static Function CreateWatcher(aqsFilter As String, additionalProperties As IEnumerable<String>) As DeviceWatcher// You can use this method in JavaScript.
- aqsFilter
- PlatForm::String String String String
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.
- additionalProperties
- IIterable<PlatForm::String> IEnumerable<String> IEnumerable<String> IEnumerable<String>
An iterable list of additional properties to include in the Properties property of the DeviceInformation objects in the enumeration results. For more info on what the properties represent, see Device information properties.
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.
- See Also
CreateWatcher(String, IIterable, DeviceInformationKind)
CreateWatcher(String, IIterable, DeviceInformationKind)
CreateWatcher(String, IIterable, DeviceInformationKind)
CreateWatcher(String, IIterable, DeviceInformationKind)
Creates a DeviceWatcher for devices matching the specified Advanced Query Syntax (AQS) string, the specified collection of properties, and the kind of devices.
public : static DeviceWatcher CreateWatcher(PlatForm::String aqsFilter, IIterable<PlatForm::String> additionalProperties, DeviceInformationKind kind)public static DeviceWatcher CreateWatcher(String aqsFilter, IEnumerable<String> additionalProperties, DeviceInformationKind kind)Public Static Function CreateWatcher(aqsFilter As String, additionalProperties As IEnumerable<String>, kind As DeviceInformationKind) As DeviceWatcher// You can use this method in JavaScript.
- aqsFilter
- PlatForm::String String String String
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.
- additionalProperties
- IIterable<PlatForm::String> IEnumerable<String> IEnumerable<String> IEnumerable<String>
An iterable list of additional properties to include in the Properties property of the DeviceInformation objects in the enumeration results. For more info on what the properties represent, see Device information properties.
The specific types of devices the DeviceWatcher is interested in.
The created DeviceWatcher.
CreateWatcher(DeviceClass) CreateWatcher(DeviceClass) CreateWatcher(DeviceClass) CreateWatcher(DeviceClass)
Creates a DeviceWatcher for devices matching the specified DeviceClass.
public : static DeviceWatcher CreateWatcher(DeviceClass deviceClass)public static DeviceWatcher CreateWatcher(DeviceClass deviceClass)Public Static Function CreateWatcher(deviceClass As DeviceClass) As DeviceWatcher// You can use this method in JavaScript.
- deviceClass
- DeviceClass DeviceClass DeviceClass DeviceClass
The class of device to enumerate using the 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.
- See Also
-
FindAllAsync() FindAllAsync() FindAllAsync() FindAllAsync()
Enumerates all DeviceInformation objects.
public : static IAsyncOperation<DeviceInformationCollection> FindAllAsync()public static IAsyncOperation<DeviceInformationCollection> FindAllAsync()Public Static Function FindAllAsync() As IAsyncOperation( Of DeviceInformationCollection )// You can use this method in JavaScript.
The object for managing the asynchronous operation.
FindAllAsync(String) FindAllAsync(String) FindAllAsync(String) FindAllAsync(String)
Enumerates DeviceInformation objects matching the specified Advanced Query Syntax (AQS) string.
public : static IAsyncOperation<DeviceInformationCollection> FindAllAsync(PlatForm::String aqsFilter)public static IAsyncOperation<DeviceInformationCollection> FindAllAsync(String aqsFilter)Public Static Function FindAllAsync(aqsFilter As String) As IAsyncOperation( Of DeviceInformationCollection )// You can use this method in JavaScript.
- aqsFilter
- PlatForm::String String String String
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.
The object for managing the asynchronous operation.
Remarks
Important
This method is not available using JavaScript. If you try to use it, your code will instead call FindAllAsync(DeviceClass) with an invalid class and return a collection with all devices. Instead, you should use FindAllAsync(String, IIterable(String) with null as the second parameter if no other properties are needed.
FindAllAsync(String, IIterable)
FindAllAsync(String, IIterable)
FindAllAsync(String, IIterable)
FindAllAsync(String, IIterable)
Enumerates DeviceInformation objects matching the specified Advanced Query Syntax (AQS) string and including the specified collection of properties.
public : static IAsyncOperation<DeviceInformationCollection> FindAllAsync(PlatForm::String aqsFilter, IIterable<PlatForm::String> additionalProperties)public static IAsyncOperation<DeviceInformationCollection> FindAllAsync(String aqsFilter, IEnumerable<String> additionalProperties)Public Static Function FindAllAsync(aqsFilter As String, additionalProperties As IEnumerable<String>) As IAsyncOperation( Of DeviceInformationCollection )// You can use this method in JavaScript.
- aqsFilter
- PlatForm::String String String String
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.
- additionalProperties
- IIterable<PlatForm::String> IEnumerable<String> IEnumerable<String> IEnumerable<String>
An iterable list of additional properties to include in the Properties property of the DeviceInformation objects in the enumeration results. For more info on what the properties represent, see Device information properties.
The object for managing the asynchronous operation.
- See Also
FindAllAsync(String, IIterable, DeviceInformationKind)
FindAllAsync(String, IIterable, DeviceInformationKind)
FindAllAsync(String, IIterable, DeviceInformationKind)
FindAllAsync(String, IIterable, DeviceInformationKind)
Enumerates DeviceInformation objects matching the specified Advanced Query Syntax (AQS) string, the device kind, and including the specified collection of properties.
public : static IAsyncOperation<DeviceInformationCollection> FindAllAsync(PlatForm::String aqsFilter, IIterable<PlatForm::String> additionalProperties, DeviceInformationKind kind)public static IAsyncOperation<DeviceInformationCollection> FindAllAsync(String aqsFilter, IEnumerable<String> additionalProperties, DeviceInformationKind kind)Public Static Function FindAllAsync(aqsFilter As String, additionalProperties As IEnumerable<String>, kind As DeviceInformationKind) As IAsyncOperation( Of DeviceInformationCollection )// You can use this method in JavaScript.
- aqsFilter
- PlatForm::String String String String
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.
- additionalProperties
- IIterable<PlatForm::String> IEnumerable<String> IEnumerable<String> IEnumerable<String>
An iterable list of additional properties to include in the Properties property of the DeviceInformation objects in the enumeration results. For more info on what the properties represent, see Device information properties.
The specific type of device to find.
The object for managing the asynchronous operation.
FindAllAsync(DeviceClass) FindAllAsync(DeviceClass) FindAllAsync(DeviceClass) FindAllAsync(DeviceClass)
Enumerates DeviceInformation objects of the specified class.
public : static IAsyncOperation<DeviceInformationCollection> FindAllAsync(DeviceClass deviceClass)public static IAsyncOperation<DeviceInformationCollection> FindAllAsync(DeviceClass deviceClass)Public Static Function FindAllAsync(deviceClass As DeviceClass) As IAsyncOperation( Of DeviceInformationCollection )// You can use this method in JavaScript.
- deviceClass
- DeviceClass DeviceClass DeviceClass DeviceClass
The class of devices to enumerate.
The object for managing the asynchronous operation.
- See Also
GetAqsFilterFromDeviceClass(DeviceClass) GetAqsFilterFromDeviceClass(DeviceClass) GetAqsFilterFromDeviceClass(DeviceClass) GetAqsFilterFromDeviceClass(DeviceClass)
Creates a filter to use to enumerate through a subset of device types.
public : static PlatForm::String GetAqsFilterFromDeviceClass(DeviceClass deviceClass)public static string GetAqsFilterFromDeviceClass(DeviceClass deviceClass)Public Static Function GetAqsFilterFromDeviceClass(deviceClass As DeviceClass) As string// You can use this method in JavaScript.
- deviceClass
- DeviceClass DeviceClass DeviceClass DeviceClass
The type of devices that you want to create a filter for.
The Advanced Query Syntax (AQS) filter used to specifically enumerate through the device type specified by deviceClass.
GetGlyphThumbnailAsync() GetGlyphThumbnailAsync() GetGlyphThumbnailAsync() GetGlyphThumbnailAsync()
Gets a glyph for the device.
public : IAsyncOperation<DeviceThumbnail> GetGlyphThumbnailAsync()public IAsyncOperation<DeviceThumbnail> GetGlyphThumbnailAsync()Public Function GetGlyphThumbnailAsync() As IAsyncOperation( Of DeviceThumbnail )// You can use this method in JavaScript.
The object for managing the asynchronous operation that will return a DeviceThumbnail
GetThumbnailAsync() GetThumbnailAsync() GetThumbnailAsync() GetThumbnailAsync()
Returns a thumbnail image for the device.
public : IAsyncOperation<DeviceThumbnail> GetThumbnailAsync()public IAsyncOperation<DeviceThumbnail> GetThumbnailAsync()Public Function GetThumbnailAsync() As IAsyncOperation( Of DeviceThumbnail )// You can use this method in JavaScript.
The object for managing the asynchronous operation that will return a DeviceThumbnail.
Update(DeviceInformationUpdate) Update(DeviceInformationUpdate) Update(DeviceInformationUpdate) Update(DeviceInformationUpdate)
Updates the properties of an existing DeviceInformation object.
public : void Update(DeviceInformationUpdate updateInfo)public void Update(DeviceInformationUpdate updateInfo)Public Function Update(updateInfo As DeviceInformationUpdate) As void// You can use this method in JavaScript.
- updateInfo
- DeviceInformationUpdate DeviceInformationUpdate DeviceInformationUpdate DeviceInformationUpdate
Indicates the properties to update.
Remarks
For more info on what the properties represent, see Device information properties.
- See Also
See Also
- Camera profiles sample (Windows 10)
- Camera preview frame sample (Windows 10)
- Basic camera app sample (Windows 10)
- Camera resolution sample (Windows 10)
- Custom USB device sample (Windows 10)
- Camera face detection sample (Windows 10)
- Video stabilization sample (Windows 10)
- Manual camera controls sample (Windows 10)
- High dynamic range sample (Windows 10)