Guia de início rápido: enumerando contêineres de dispositivos (HTML)

Artigo
12/12/2015

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Os tipos de objeto PnP (Plug and Play) nas informações de dispositivo do repositório de enumeração PnpObjectType associadas a determinada interface de dispositivo, o dispositivo do qual a interface faz parte, uma classe de interfaces de dispositivos ou o contêiner do dispositivo que representa todo o produto de hardware. O contêiner de dispositivo descreve os aspectos visíveis de um dispositivo, como o nome do fabricante ou do modelo. Windows.Devices.Enumeration.DeviceInformation representa o mesmo tipo que PnpObjectType.DeviceInterface.

O namespace Windows.Devices.Enumeration.PnP permite enumerar dispositivos e contêineres de dispositivos, além de dispositivos e interfaces de dispositivos. Este tópico mostra como usar o namespace Windows.Devices.Enumeration.PnP para enumerar contêineres de dispositivos.

Objetivo: Enumerar propriedades de contêineres de dispositivos.

Pré-requisitos

Você precisa conhecer JavaScript e HTML.

Tempo para conclusão: 20 minutos.

Instruções

1. Abrir o Microsoft Visual Studio

Abra uma instância do Visual Studio.

2. Criar um novo projeto

Na caixa de diálogo Novo Projeto, nos tipos de projetos JavaScript > Aplicativos da Windows Store, clique em Aplicativo em Branco.

3. Insira o HTML do aplicativo

Abra Default.html e copie esse código no arquivo, substituindo seu conteúdo.


<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <script src="/js/default.js"></script>
</head>
<body data-design-activate="defaultPage.activated">
    <h1>Device Enumeration Sample</h1>

    <h2 >Input</h2>

    <div>            

       <div id="Input">
         <p>This scenario demonstrates enumerating device containers.</p>
          <p>Pressing the enumerate button will start a
             search for device containers.
             The containers will be listed below.</p>
          <input onclick="onEnumerateDeviceContainers()" type="button" value="Enumerate" />
                <br /><br />
       </div>
    </div>


    <h2> Output</h2>

            <div id="statusMessage"></div>

            <!-- Container Enumeration results are displayed in this element -->
            <div  id="output"></div>
</body>
</html>

4. Insira o JavaScript

Em Default.js, insira este código.


function onEnumerateDeviceContainers() {
    try {

        document.getElementById("output").innerHTML = "";

        var propertiesToRetrieve = new Array();
        propertiesToRetrieve.push("System.ItemNameDisplay");
        propertiesToRetrieve.push("System.Devices.ModelName");
        propertiesToRetrieve.push("System.Devices.Manufacturer");

        var DevEnum = Windows.Devices.Enumeration;
        var Pnp = DevEnum.Pnp;
        var pnpObjType = Pnp.PnpObjectType;
        var deviceContainerType = pnpObjType.deviceContainer;

        Pnp.PnpObject.findAllAsync(
            deviceContainerType, 
            propertiesToRetrieve).then(
                function (devinfoCollection) {
                    var numDevices = devinfoCollection.length;
                    document.getElementById("statusMessage").innerHTML = 
                        numDevices + " device containers(s) found";
                    if (numDevices) {
                        for (var i = 0; i < numDevices; i++) {
                            printDeviceContainer(devinfoCollection[i], 
                            document.getElementById("output"));
                        }
                    } else {
                    document.getElementById("statusMessage").innerHTML = 
                        ("No devices found");
                    }
                },
                function (e) {
                    document.getElementById("statusMessage").innerHTML = 
                        ("Failed to find devices, error: " + e.message);
                });
    } catch (e) {
        document.getElementById("statusMessage").innerHTML = 
            ("Failed to enumerate 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 />";
}

function printDeviceContainer(deviceContainer, log) {
    var prop = deviceContainer.properties;
    if (prop) {
        log.innerHTML += "<h3>" + prop.lookup("System.ItemNameDisplay") + "<h3/>";
        log.innerHTML += "<p>Container ID: " + deviceContainer.id + "<p/>";
        printProperties(log, prop);
    }
    log.innerHTML += "<br /><br />";
}

Resumo

Você acabou de enumerar as propriedades do contêiner de dispositivos. Note que o parâmetro requestedProperties para Windows.Devices.Enumeration.Pnp.findAllAsync é requerido para que os resultados de uma enumeração de contêiner contenham propriedades.

Partilhar via