Comment récupérer les propriétés supplémentaires pour un périphérique ou un objet PnP (HTML)

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Décrit comment obtenir les propriétés supplémentaires à partir de DeviceInformation ou de PnpObject.

Spécification des propriétés supplémentaires

Par défaut, findAllAsync et createWatcher retournent des objets DeviceInformation qui sont dotés des propriétés suivantes :

Vous pouvez utiliser les formes surchargées des méthodes findAllAsync et createWatcher qui sont disponibles sur les classes DeviceInformation et PnpObject. Vous pouvez spécifier les propriétés supplémentaires à inclure dans les résultats à l’aide du paramètre additionalProperties, comme suit.

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

Liste des noms canoniques

Si la valeur d’une propriété n’est pas associée à une interface de périphérique particulière, elle est peut-être associée au périphérique dont fait partie l’interface ou l’objet de conteneur de périphérique qui représente les aspects visibles d’un matériel périphérique, tels que le nom du fabricant ou le nom de modèle. Les listes suivantes sont des listes de noms de propriétés pour les interfaces de périphériques, les périphériques et les conteneurs de périphériques. Voir Récupération des objets PnP associés pour apprendre à naviguer entre les types d’objets.

Propriétés d’interface de périphérique

Propriétés du périphérique

Propriétés du conteneur

Spécification des propriétés qui ne sont pas dotées de nom canonique

Si aucun nom canonique n’a été spécifié pour une propriété, elle peut quand même être récupérée en spécifiant la clé en tant que chaîne sous la forme « {Guid} pid ». Par exemple, System.Devices.ContainerId peut être spécifié sous la forme « {8C7ED206-3F8A-4827-B3AB-AE9E1FAEFC6C} 2 ».

Rubriques associées

Concepts

Propriétés de périphérique définies par le système

Modèle de propriétés de périphérique unifiées