Come recuperare altre proprietà di un dispositivo o un oggetto Plug and Play (HTML)

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Spiega come recuperare altre proprietà di dispositivo da DeviceInformation o da PnpObject.

Specificare altre proprietà

Per impostazione predefinita, findAllAsync e createWatcher restituiscono oggetti DeviceInformation con le proprietà seguenti:

Puoi usare i moduli di overload dei metodi findAllAsync e createWatcher disponibili nelle classi DeviceInformation e PnpObject. Puoi specificare altre proprietà da includere nei risultati mediante il parametro additionalProperties come descritto di seguito.

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

Elenco delle proprietà canoniche

Se il valore di una proprietà non è associato a una determinata interfaccia di dispositivo, può essere associato al dispositivo di cui l'interfaccia fa parte oppure all'oggetto contenitore del dispositivo che rappresenta gli aspetti visibili di un prodotto hardware, come ad esempio il nome del produttore o del modello. Di seguito sono elencati i nomi di proprietà relativi a interfacce di dispositivi, dispositivi e contenitori di dispositivi. Per informazioni su come passare da un tipo di oggetti a un altro, vedi Recupero di oggetti PnP correlati.

Proprietà delle interfacce di dispositivi

Proprietà dei dispositivi

Proprietà del contenitore

Specificare le proprietà che non hanno un nome canonico

Quando il nome canonico della priorità non è specificato, può essere comunque recuperato specificando la chiave sotto forma di stringa "{Guid} pid" del modulo. Ad esempio, è possibile specificare System.Devices.ContainerId come "{8C7ED206-3F8A-4827-B3AB-AE9E1FAEFC6C} 2".

Argomenti correlati

Concetti

Proprietà del dispositivo definite dal sistema

Modello unificato di proprietà del dispositivo