How to retrieve additional properties for a device or PnP object (HTML)

Describes how to get additional device properties from a DeviceInformation or PnpObject.

Specifying additional properties

By default, findAllAsync and createWatcher return DeviceInformation objects that have the following properties:

You can use the overloaded forms of the findAllAsync and createWatcher methods that are available on the DeviceInformation and PnpObject classes. You can specify additional properties to include in the results by using the additionalProperties parameter, as follows.

// Create a set of two additional properties.
    var propertiesToRetrieve = new Array();
    propertiesToRetrieve.push("System.Devices.InterfaceClassGuid");
    propertiesToRetrieve.push("System.Devices.ContainerId");

    Windows.Devices.Enumeration.findAllAsync(selectorString, 
             propertiesToRetrieve).then(successCallback, errorCallback);)

// Handles successful completion of the findAllAsync method.
function successCallback(deviceInformationCollection) {
    var numDevices = deviceInformationCollection.length;
    if (numDevices) {
        for (var i = 0; i < numDevices; i++) {
            printProperties(document.getElementById("log"),
                 deviceInformationCollection[i].properties);
        }
    } 
}

// Handles an error completion of the findAllAsync method.
function errorCallback(e) {
    document.getElementById("statusMessage").innerHTML = 
        "Failed to find devices, error: " + e.message;
}

function printProperties(log, prop) {
    log.innerHTML += "property store count is: " + prop.size;
    var pt = prop.first();
    while (pt.hasCurrent) {
        log.innerHTML += "<br />" + pt.current.key + " := " + pt.current.value;
        pt.moveNext();
    }
    log.innerHTML += "<br />";
}

List of canonical properties

If a property value is not associated with a particular device interface, it may be associated with the device that the interface is part of, or the device container object that represents the visible aspects of a device hardware product, such as manufacturer or model name. The following are lists of property names for device interfaces, devices, and device containers. See Retrieving related PnP objects to learn how to navigate between object types.

Device interface properties

Device properties

Container properties

Specifying properties that don't have a canonical name

When a property doesn't have a canonical name specified, it can still be retrieved by specifying the key as a string of the form "{Guid} pid". For example, System.Devices.ContainerId can be specified as "{8C7ED206-3F8A-4827-B3AB-AE9E1FAEFC6C} 2".

Related topics

Concepts

System-Defined Device Properties

Unified Device Property Model