Как получить дополнительные свойства устройства или самонастраивающегося объекта (HTML)

[ Эта статья адресована разработчикам приложений среды выполнения Windows для Windows 8.x и Windows Phone 8.x. При разработке приложений для Windows 10 см. раздел последняя документация]

Здесь объясняется, как получить дополнительные свойства устройства из DeviceInformation или PnpObject.

Указание дополнительных свойств

По умолчанию методы findAllAsync и createWatcher возвращают объекты DeviceInformation с указанными ниже свойствами.

Вы можете использовать перегруженные формы методов findAllAsync и createWatcher, которые доступны в классах DeviceInformation и PnpObject. Для включения в результаты вы можете указать дополнительные свойства, используя параметр additionalProperties, как описано ниже.

// 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 />";
}

Список канонических свойств

Если значение свойства не связано с определенным интерфейсом устройства, оно может быть связано с устройством, частью которого является интерфейс, или с объектом-контейнером устройства, представляющим видимые аспекты оборудования устройства, такие как данные об изготовителе или название модели. Далее представлены списки имен свойств устройств, их интерфейсов и контейнеров. В разделе Получение связанных самонастраивающихся объектов объясняется, как переходить от одного типа объектов к другому.

Свойства интерфейса устройства

Свойства устройства

Свойства контейнера

Указание свойств, которые не имеют канонического имени

Когда указывается свойство без канонического имени, его можно также получить с помощью указания ключа в качестве строки формы "{Guid} pid". Например, свойство System.Devices.ContainerId можно указать как "{8C7ED206-3F8A-4827-B3AB-AE9E1FAEFC6C} 2".

Связанные разделы

Понятия

Свойства устройства, определяемые системой

Унифицированная модель свойств устройства