デバイスまたは PnP オブジェクトの追加のプロパティを取得する方法 (HTML)

DeviceInformation または PnpObject から追加のデバイス プロパティを取得する方法を説明します。

追加のプロパティの指定

既定では、findAllAsync と createWatcher が返す DeviceInformation オブジェクトには、次のプロパティがあります。

DeviceInformation および PnpObject クラスで使用可能な findAllAsync および createWatcher メソッドのオーバーロード形式を使うことができます。次のように 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 />";
}

正規プロパティの一覧

プロパティ値が特定のデバイス インターフェイスと関連付けられていない場合、インターフェイスがその一部であるデバイスと、または製造元やモデル名のようなデバイス ハードウェア製品の表示される部分を表すデバイス コンテナー オブジェクトと、関連付けることができます。 デバイス インターフェイス、デバイス、デバイス コンテナーのプロパティ名の一覧を次に示します。オブジェクトの種類間を移動する方法については、「関連する PnP オブジェクトの取得」をご覧ください。

デバイス インターフェイスのプロパティ

デバイスのプロパティ

コンテナーのプロパティ

正規名を持たないプロパティの指定

プロパティに正規名が指定されていない場合でも、"{Guid} pid" の形式の文字列としてキーを指定することにより、プロパティを取得できます。 たとえば、System.Devices.ContainerId は "{8C7ED206-3F8A-4827-B3AB-AE9E1FAEFC6C} 2" と指定できます。

関連トピック

概念

システム定義のデバイスのプロパティ

統一されたデバイス プロパティ モデル