42
Pipeline de pacotes de metadados do dispositivo 28 de setembro de 2012 Resumo Este documento descreve como instalar e usar um pacote de metadados do dispositivo para os recursos da experiência de dispositivo do Windows 7 e do Windows 8. Este documento deve ser usado como um tutorial e como um guia de referência. Ele oferece informações sobre como instalar um pacote de metadados, como depurar erros de pacote de metadados de dispositivo, como o Cliente de Recuperação de Metadados de Dispositivo (DMRC) seleciona um pacote de metadados, e como o DMRC usa o cache de metadados. Estas informações aplicam-se aos seguintes sistemas operacionais: Windows 8 Windows 7 As referências e os recursos discutidos aqui estão em uma lista no fim do documento. A versão atualizada deste documento é mantida na Web, em: Pipeline de pacotes de metadados do dispositivo Aviso de Isenção: Este documento é fornecido “como está”. As informações e opiniões expressas neste documento, incluindo URLS e outras referências de sites de Internet, podem ser alteradas sem aviso prévio. Algumas informações referem-se a produtos pré-lançados que podem ser substancialmente modificados antes da respectiva comercialização. A Microsoft não faz garantias, expressas nem implícitas, quanto às informações apresentadas aqui. O uso é por conta e risco do usuário. Alguns exemplos representados aqui são fornecidos apenas para ilustração e são fictícios. Nenhuma associação real ou conexão é desejada ou deve ser inferida.

Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

  • Upload
    others

  • View
    10

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo

28 de setembro de 2012

Resumo

Este documento descreve como instalar e usar um pacote de metadados do dispositivo para os recursos da experiência de dispositivo do Windows 7 e do Windows 8. Este documento deve ser usado como um tutorial e como um guia de referência. Ele oferece informações sobre como instalar um pacote de metadados, como depurar erros de pacote de metadados de dispositivo, como o Cliente de Recuperação de Metadados de Dispositivo (DMRC) seleciona um pacote de metadados, e como o DMRC usa o cache de metadados.

Estas informações aplicam-se aos seguintes sistemas operacionais:

Windows 8 Windows 7

As referências e os recursos discutidos aqui estão em uma lista no fim do documento.

A versão atualizada deste documento é mantida na Web, em: Pipeline de pacotes de metadados do dispositivo

Aviso de Isenção: Este documento é fornecido “como está”. As informações e opiniões expressas neste documento, incluindo URLS e outras referências de sites de Internet, podem ser alteradas sem aviso prévio. Algumas informações referem-se a produtos pré-lançados que podem ser substancialmente modificados antes da respectiva comercialização. A Microsoft não faz garantias, expressas nem implícitas, quanto às informações apresentadas aqui. O uso é por conta e risco do usuário.Alguns exemplos representados aqui são fornecidos apenas para ilustração e são fictícios. Nenhuma associação real ou conexão é desejada ou deve ser inferida.Este documento não inclui nenhum direito legal sobre qualquer propriedade intelectual de qualquer produto da Microsoft. Você pode copiar e usar este documento para fins de referência interna. © 2012 Microsoft. Todos os direitos reservados.

Page 2: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 2

Histórico do documentoData Alteração28 de setembro de 2012 Atualizado para refletir nova identidade visual

27 de junho de 2012 Informações atualizadas sobre eventos ETW

9 de abril de 2012 Terminologia do Windows 8 atualizada28 de fevereiro de 2012 Atualizado para o Windows 8 Consumer Preview22 de janeiro de 2010 Observou que uma conta convidado não pode acessar pacotes de

metadados no servidor WMIS.Adicionou orientação sobre o uso de uma seção separada INF DDInstall se o seu dispositivo também for instalado em versões do Windows anteriores ao Windows 7.Acrescentou informações sobre o cache de metadados de dispositivo DMRC.Informações de depuração ajustadas para refletir apenas um canal de Visualizador de Eventos (DeviceMetadata/Debug).

1 de julho de 2009 Corrigiu nomes de elementos XML1 de junho de 2009 Corrigido um erro do exemplo INF com o sinalizador

COPYFLG_NODECOMPAdicionou a seção “Como o DMRC seleciona um pacote de metadados de dispositivo”

5 de novembro de 2008 Primeira publicação

ConteúdoAdicionar pacotes de metadados a imagem do Windows offline..............................3Instalar pacotes de metadados em uma instância em execução do Windows..........3

Instalar pacote de metadados do servidor WMIS.................................................4Instalar os pacotes de metadados usando um aplicativo......................................4Instalar os pacotes de metadados usando um arquivo INF em um pacote de driver.....................................................................................................................4

Aplicar o pacote de metadados do dispositivo a seu sistema para teste.......................6Assinatura do pacote de metadados do dispositivo e modo de teste...........................6Como o DMRC seleciona um pacote de metadados do dispositivo...............................7Como o DMRC determina se pesquisar o servidor WMIS..............................................9

Práticas recomendadas para testar o download do pacote de metadados de dispositivos.........................................................................................................11

Depuração da instalação do pacote de metadados de dispositivo..............................12Verifique se o pacote de metadados do dispositivo está instalado.........................12Depurar as propriedades do contêiner de dispositivo usando Ddodiag.exe...........12

Executar Ddodiag.exe.........................................................................................12Depurar usando o ETW (Rastreamento de Eventos para Windows) no Windows 713

Ver os eventos do ETW de Device Metadata/Debug no Visualizador de Eventos............................................................................................................................14Eventos do ETW de Device Metadata/Debug.....................................................14

Depurar usando o ETW (Rastreamento de Eventos para Windows) no Windows 816Ver os eventos do ETW de Device Metadata/Debug no Visualizador de Eventos............................................................................................................................16Eventos do ETW de Device Metadata/Debug.....................................................16

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 3: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 3

Depurar usando relatório de problemas (Centro de ação)......................................20Exibir um relatório de problemas no Centro de Ação.........................................20Interpretar um relatório de problema................................................................21

Determinar o código de erro relacionado aos metadados do dispositivo...............21Apêndice......................................................................................................................22

Depurar configuração do dispositivo usando o ETW (Rastreamento de Eventos para Windows) no Windows 8.........................................................................................22

Ver os eventos ETW de configuração do dispositivo no Visualizador de Eventos............................................................................................................................23Eventos ETW de configuração do dispositivo......................................................23

Glossário......................................................................................................................30Recursos......................................................................................................................31

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 4: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 4

Instalação do pacote de metadados do dispositivoVocê pode adicionar pacotes de metadados de dispositivo a uma imagem offline do Windows, ou você pode instalar pacotes adicionais de metadados do dispositivo enquanto o Windows estiver em execução.

Adicionar pacotes de metadados a imagem do Windows offlinePara adicionar pacotes de metadados dispositivo a uma imagem offline do Windows, copie os pacotes (por exemplo, GUID.devicemetadata-ms) ao repositório de metadados local (%PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore\<locale>).

Observações: Você tem que criar a pasta <locale> com base na localidade do pacote de

metadados no repositório local de metadados. Por exemplo, %PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore\pt-BR. Copie o pacote de metadados local apropriado na subpasta. Por exemplo, copie um pacote de metadados EN-US para a subpasta EN-US, e copie um pacote de metadados EN para a subpasta EN .

Pacotes de metadados do dispositivo de múltipla de localidade também devem ser copiados para a pasta local. A localidade é definida em packageinfo.xml, que é utilizado apenas quando o pacote de metadados do dispositivo é carregado para um computador com Windows 7. Por exemplo, o pacote deve ser copiado para a pasta EN-US se a localidade em packageinfo.xml for EN-US.

Instalar pacotes de metadados em uma instância em execução do Windows

Você pode instalar pacotes de metadados do dispositivo em uma instância em execução do Windows de três maneiras diferentes:

Instale pacotes de metadados do servidor dos Serviços de Metadados e Internet do Windows (WMIS).

Instalar pacotes de metadados usando um aplicativo.

Instale pacotes de metadados usando um arquivo INF em um pacote de driver (não recomendamos).

Estas três maneiras usam os mesmos processos e copiam os pacotes de metadados para o repositório de metadados local.

Instalar pacote de metadados do servidor WMIS Quando o Windows detecta um novo dispositivo, ele pede ao servidor WMIS online um pacote de metadados para o dispositivo. Se um pacote de metadados de dispositivo estiver disponível, o Cliente de Recuperação de Metadados de Dispositivo (DMRC) de computadores locais baixa o pacote do servidor WMIS e instala o pacote no computador local.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 5: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 5

Você pode enviar seus metadados nas áreas do Dashboard de Desenvolvimento de Hardware e Desenvolvimento de Aplicativos de Área de Trabalho do Centro de Desenvolvimento do Windows. Veja http://msdn.microsoft.com/library/c71750f4-885f-425a-a3ad-29740a1cb0bb entender os requisitos do logotipo e saber se eles se aplicam ao seu envio. Após o Dashboard validar o seu pacote de metadados, ele estará disponível para o WMIS para solicitações de download que o DMRC faz em qualquer computador com o Windows 7.

Para dar suporte ao cenário de instalação de pacote de metadados de dispositivo com o primeiro cenário de instalação de hardware, recomendamos usar este método para fornecer pacotes de metadados.

Observação: Se um usuário acessar um computador usando uma conta de convidado, o DMRC não poderá recuperar o pacote de metadados de dispositivos do servidor WMIS para esse usuário.

Instalar os pacotes de metadados usando um aplicativoPara instalar pacotes de metadados, seu aplicativo ou aplicativo de instalação deve seguir estes procedimentos:

1. Obter o caminho do repositório local de metadados chamando SHGetKnownFolderPath. O knownfolderID para o repositório de metadados local é {5CE4A5E9-E4EB-479D-B89F-130C02886155}.

2. Copie o pacote de metadados para o repositório de metadados local chamando CopyFile.

Observações: Você deve ter privilégios de administrador quando copiar pacotes de

metadados.

Você deve copiar os pacotes de metadados para a subpasta local correta. Por exemplo, copie um pacote de metadados para”EN-US” para %PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore\EN-US.

Se o repositório de metadados local não tiver um subdiretório para a localidade, o aplicativo deverá criar-lo. Se você usa a função CopyFile, ela cria a pasta se não houver um subdiretório para o local.

Instalar os pacotes de metadados usando um arquivo INF em um pacote de driverObservação: Como não fornecemos suporte para o método de arquivo INF para instalar pacotes de metadados, recomendamos que você instale a partir do servidor WMIS. Porém, se você decidir usar um arquivo INF, leia esta seção completa e tenha certeza de que entendeu o risco.

Para instalar pacotes de metadados de um pacote de driver, seu arquivo INF copia os pacotes de metadados. Para mais informações sobre o arquivo INF, veja “Arquivos INF” no Kit de Driver do Windows (WDK).

Observação: Se o seu pacote de driver for usado para instalar dispositivos em versões do Windows anteriores ao Windows 7, use uma seção separada INF DDInstall

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 6: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 6

que contém os as diretivas INF relacionadas com os metadados. Você deve especificar este nome da seção na seção Modelos INF usando uma decoração TargetOSversion que especifica um valor OSMajorVersion e OSMinorVersion para o Windows 7. Se você não usar uma seção DDInstall separada para o Windows 7, a instalação do pacote de driver mostrará um alerta de assinatura porque o COPYFLG_NODECOMP não funciona em versões do Windows anteriores ao Windows 7. Para mais informações sobre como criar seções de INF decoradas, consulte "Criando arquivos INF para várias plataformas e sistemas operacionais" no WDK.

O exemplo a seguir mostra como as seções DestinationDirs e DDInstall especificam os caminhos para as operações de pacotes de metadados:

[SourceDisksNames]1 = %Media_Description%,,,\MetadataPackage ;

[SourceDisksFiles.NTx86]GUID1.devicemetadata-ms= 1,, ;A arquivo pacote de metadados para EN-USGUID2.devicemetadata-ms= 1,, ;A arquivo pacote de metadados para AR-SAGUID3.devicemetadata-ms= 1,, ;A arquivo pacote de metadados para JA-JP

[DestinationDirs]COPYMETADATA_EN-US = 24, \ProgramData\Microsoft\Windows\DeviceMetadataStore\EN-US ;COPYMETADATA_AR-SA = 24, \ProgramData\Microsoft\Windows\DeviceMetadataStore\AR-SA ;COPYMETADATA_JA-JP = 24, \ProgramData\Microsoft\Windows\DeviceMetadataStore\JA-JP ;. . .

[DeviceInstall.NTx86]CopyFiles=COPYMETADATA_EN-USCopyFiles=COPYMETADATA_AR-SACopyFiles=COPYMETADATA_JA-JP

[COPYMETADATA_EN-US]GUID1.devicemetadata-ms,,,0x00000800 ;COPYFLG_NODECOMP[COPYMETADATA_AR-SA]GUID2.devicemetadata-ms,,,0x00000800 ;COPYFLG_NODECOMP[COPYMETADATA_JA-JP]GUID3.devicemetadata-ms,,,0x00000800 ;COPYFLG_NODECOMP

Observações: Você deve copiar todos os pacotes de metadados do pacote de driver para a

pasta correta no Repositório de Metadados de Dispositivo Local para suportar alteração dinâmica de local.

Os pacotes de metadados não devem ser copiados por um co-instalador ou um instalador de classe.

Você deve especificar o sinalizador COPYFLG_NODECOMP na diretiva CopyFIles. Este sinalizador garante que a integridade binária do pacote de metadados de dispositivo seja mantida e evita uma descompressão do pacote de metadados de dispositivo quando o pacote de driver estiver instalado.

Você deve assinar o pacote de metadados, se estiver incluído em um pacote de driver que será assinado.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 7: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 7

Qualquer falha na instalação do pacote de metadados faz com que a instalação do driver falhe.

Aplicar o pacote de metadados do dispositivo a seu sistema para teste

O pacote de metadados do dispositivo é instalado automaticamente quando você instala um dispositivo no sistema do usuário. Mas você tem que pressionar a tecla F5 em Dispositivos e Impressoras ao copiar o pacote de metadados do dispositivo após instalá-lo no repositório local de metadados para fins de teste. Neste caso, siga as etapas abaixo:

1. Vá para o menu Iniciar.

2. Digite Dispositivos e Impressoras.

3. Clique em Configurações no painel Pesquisar.

4. Clique em Dispositivos e Impressoras.

5. Pressione a tecla F5.

Observação: Se você usa a ferramenta de criação de metadados do dispositivo ou a ferramenta de implantação de driver WDK, não tem que pressionar a tecla F5, pois essas ferramentas atualizam automaticamente o banco de dados de metadados do dispositivo.

Assinatura do pacote de metadados do dispositivo e modo de testePara usar os aplicativos de dispositivo da Windows Store, o aplicativo de dispositivo especializado, o Device Stage e a Reprodução Automática de dispositivos, seu pacote de metadados do dispositivo pede uma assinatura (os usuários obtêm o pacote de metadados do dispositivo do WMIS), ou seu sistema precisa estar em modo de teste (para realizar o teste). Ao fazer o teste de seu pacote de metadados do dispositivo antes de enviá-lo à Microsoft, você precisa colocar o sistema em modo de teste. Para colocar seu PC emmodo de teste, siga estas etapas:

1. Abra um prompt de comando com acesso elevado.

2. Execute bcdedit -set testsigning on.

3. Reinicialize o sistema.

Você vê Modo de Teste na área de trabalho enquanto o PC está em modo de teste.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 8: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 8

Como o DMRC seleciona um pacote de metadados do dispositivoQuando um usuário abre a interface de usuário Dispositivos e impressoras ou Estágio do dispositivo™ ,o sistema operacional abre o DMRC para pesquisar o cache para o pacote de metadados atual mais adequado para um dispositivo. O DMRC também procura por um pacote mais recente de metadados para o dispositivo no servidor WMIS. Se o DMRC encontra um pacote, ele baixa o pacote e o instala no computador.

Se o DMRC tiver consultado recentemente o servidor WMIS por um pacote de metadados para um dispositivo, ele usará um pacote de metadados em cache para o dispositivo em vez de procurar um novo pacote. Para saber mais, veja “Como o DMRC determina se deve pesquisar no servidor WMIS” mais adiante neste documento.

O DMRC usa os seguintes elementos de metadados XML que são especificados nos pacotes de metadados para selecionar o pacote apropriado para um dispositivo. A ordem desses elementos XML reflete a prioridade que o DMRC utiliza para selecionar um pacote de metadados: 1. ModelID e ModelIDList

2. HardwareID e HardwareIDList

3. Local

4. LastModifiedDate

Quando o DMRC seleciona um pacote de metadados para um dispositivo, ele segue estas etapas:1. Se o dispositivo tiver uma ID de modelo, o DMRC pesquisa o pacote de

metadados de dispositivos em busca de uma correspondência entre uma entrada ModelID no elemento XML do ModelIDList do pacote e o valor da ID de modelo do dispositivo.

2. Se o dispositivo tiver uma ID de modelo, o DMRC pesquisa o pacote de metadados de dispositivos em busca de uma correspondência entre as entradas HardwareID no elemento XML do HardwareIDList e o valor das IDs de hardware do dispositivo.

3. O DMRC cria uma lista de pacotes de metadados de dispositivos que atendem aos critérios de pesquisa descritos nas etapas 1 e 2. Em uma lista, em seguida, o DMRC pesquisa as entradas da lista em busca de uma correspondência entre o elemento XML do pacote Locale e a lista de locais preferidos do usuário no computador.

Se nenhuma entrada da lista corresponder a este critério, o DMRC busca na lista entrada para um pacote de metadados de dispositivo que contenha um elemento XML Locale que tenha o atributo default definido como true. Se o DMRC encontrar uma correspondência, ele selecionará esse pacote de metadados.

No Windows 8, se o sinalizador de localidade múltipla for definido como true, esse pacote de metadados de dispositivo será tratado como a mais alta classificação para corresponder à localidade.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 9: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 9

4. Se o DMRC encontrar mais de um pacote de metadados de dispositivo durante a etapa3, ele selecionará o pacote que tiver um elemento XML LastModifiedDate com o carimbo de data e hora mais recente.

Para mais informações sobre o esquema XML de metadados e os elementos, leia “Como criar um pacote de metadados de dispositivo para dispositivos e impressoras” no site do Centro de Desenvolvimento do Windows-Hardware.

A Figura 1 mostra como o DMRC seleciona os pacotes de metadados de dispositivo.

Iniciar

O dispositivo reporta um ID de

modelo?

Algum pacote de metadados contém o

ID de modelo?

Sim

Retorna ‘Nenhum pacote de

metadados localizado’

Não

Concluir

Mais de 1 pacote de metadados?

Sim

Algum pacote de metadados contém o

ID de hardware do dispositivo?

Não

Sim

Os pacotes contém

localidade de usuário?

Sim

Mais de 1 pacote de metadados?

Sim

Escolher um pacote com

‘ LastModifiedDate’ mais recente

Não

NãoUm pacote define a localidade padrão?Não

Retornar o pacote de metadados

Sim

Não

Não

Figura 1. Como o DMRC seleciona um pacote de metadados

Observações: Se o DMRC selecionar um pacote de metadados baseado nas IDs do

hardware, ele usará a mesma classificação de IDs de hardware que o sistema

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 10: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 10

operacional usa durante a instalação do driver. O DMRC classifica uma ID de hardware mais específica maior do que uma ID de hardware menos específica. Por exemplo, as IDs de hardware seguintes estão listadas na ordem de classificação:

<HardwareID>DOID:USB\VID_XXXX&PID_YYYY&REV_0000</HardwareID><HardwareID>DOID:USB\VID_XXXX&PID_YYYY</HardwareID>Para saber mais sobre as IDs de hardware em um contêiner de dispositivo, leia “Como criar um pacote de metadados de dispositivo para dispositivos e impressoras” no site do Centro de Desenvolvimento do Windows-Hardware.

Apenas uma metadados pacote de para um dispositivo deve definir o atributo default do elemento XML Locale como true. Defina esse atributo como true no pacote que contém uma ID de hardware com o valor de classificação mais alto.

O elemento XML LastModifiedDate é usado para controle de versão e para selecionar uma nova versão de um pacote de metadados de dispositivos para um dispositivo.

Se dois ou mais pacotes de metadados de dispositivos no repositório de metadados locais contêm os mesmos valores para os elementos XML ModelIDList, HardwareIDList, Locale ou LastModifiedDate, o DMRC seleciona somente um deles para o dispositivo. Observe que o DMRC seleciona um desses pacotes de maneira não determinada.

Como o DMRC determina se pesquisar o servidor WMISPara reduzir o tráfego de rede na rede local de um usuário, o DMRC mantém um cache de pacote de metadados de dispositivo. Quando um usuário abre Dispositivos e Impressoras, quando a Reprodução Automática inicia o Device Stage ou quando uma tarefa de manutenção periódica é iniciada no Windows 8, o DMRC segue estas etapas para determinar se é hora de pesquisar no servidor WMIS por um pacote de metadados mais recente:1. Se a ID do dispositivo de destino não estiver listada na tabela de índice do DMRC,

o DMRC está pesquisando por um pacote de metadados para o dispositivo pela primeira vez. Assim, o DMRC pesquisa no servidor WMIS.

2. Se a ID do dispositivo de destino estiver listada na tabela de índice do DMRC, o DMRC calcula se é hora pesquisar novamente no servidor WMIS:

Se o DMRC tiver recuperado antes um pacote de metadados de dispositivo para o dispositivo, ele compara o valor da chave de registro CheckBackMDRetrieved com o valor de hoje menos LastCheckedDate. Se o valor de CheckBackMDRetrieved for menor, o DMRC consulta o servidor WMIS.

Se o DMRC não tiver sido previamente retirado um pacote de metadados de dispositivo para o dispositivo, o DMRC compara o valor da chave de registro do CheckBackMDNotRetrieved com o valor de hoje menos LastCheckedDate. Se o valor de CheckBackMDNotRetrieved for menor, o DMRC consulta o servidor WMIS.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 11: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 11

A Figura 2 resume os algoritmos que o DMRC usa para determinar quando consultar o servidor WMIS em busca de pacotes de metadados atualizados.

Iniciar

Já consultou um pacote de metadados para o dispositivo? (O ID de hardware desse dispositivo está listado no índice DMRC?)

O dispositivo tem um pacote de metadados?

Sim

Hoje – LastCheckedDate > CheckBackMDRetrieved?

Sim

Hoje – LastCheckedDate > CheckBackMDNotRetrieved?

Não

Consultar servidor WMIS

Sim

Concluir

Não

Sim

Não

Figura 2. Como o DMRC determina se deve consultar o servidor WMIS em busca de um pacote de metadados de dispositivo

A lista seguinte descreve os valores que são utilizados nos algoritmos na Figura 2: LastCheckedDateEsse valor indica a data mais recente, quando o DMRC consultou o servidor de WMIS de metadados para um dispositivo. Esta data não indica se o DMRC recuperou com êxito um pacote de metadados, ela só indica a última vez que o DMRC consultou o servidor de WMIS em nome do dispositivo.

CheckBackMDNotRetrieved Este valor de registo indica o número de dias que o DMRC espera antes de verificar novamente o servidor WMIS de metadados para um dispositivo. Este valor aplica-se a dispositivos para os quais o DMRC ainda não recuperou metadados do WMIS.Caminho HKCU\Software\Microsoft\Windows\CurrentVersion\DeviceMetadataChave CheckBackMDNotRetrievedValor 0 a 256: REG_DWORD

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 12: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 12

Caminho HKCU\Software\Microsoft\Windows\CurrentVersion\DeviceMetadataValor padrão 5

CheckBackMDRetrievedEste valor de registo indica o número de dias que o DMRC espera antes de verificar metadados atualizados para um dispositivo. Este valor aplica-se a dispositivos para os quais o DMRC recebeu metadados previamente.Caminho HKCU\Software\Microsoft\Windows\CurrentVersion\DeviceMetadataChave CheckBackMDRetrievedValor 0 a 256: REG_DWORDValor padrão 8

Observação: O WMIS controla os valores de CheckBackMDRetrieved e CheckBackMDNotRetrieved. A equipe WMIS seleciona os valores com base nas condições da rede e no balanceamento de carga. Cada resposta do servidor WMIS contém os dados de configuração de cliente e controla o comportamento do DMRC.

Práticas recomendadas para testar o download do pacote de metadados de dispositivosPor causa do cache de metadados DMRC, um atraso pode ocorrer entre o momento em que um pacote de metadados de dispositivo está disponível no servidor WMIS e o momento em que o pacote é baixado para um sistema de cliente. Para testar o download de um pacote de metadados de dispositivo, você pode forçar o download de duas maneiras:

Excluindo a pasta de cache de metadados do dispositivo (%LOCALAPPDATA%\Local\Microsoft\Device Metadata\). A exclusão desta pasta redefine o valor de LastCheckedDate e faz com que o DMRC consulte o servidor WMIS para todos os dispositivos como uma consulta de primeira vez.

No Windows 8, o cache de metadados de dispositivo fica localizado em %PROGRAMDATA%\Microsoft\Windows\DeviceMetadataCache

Defina as chaves de registro CheckBackMDRetrieved e CheckBackMDNotRetrieved como 0. Quando esses valores forem zero, o DMRC consulta o servidor WMIS para um dispositivo de destino. Observe que o WMIS sobrescreve este valores cada vez que o DMRC recebe uma resposta do WMIS. Assim, esses parâmetros podem mudar se o DMRC receber uma resposta para qualquer outro dispositivo antes de ele consultar o servidor WMIS para seu dispositivo de destino.

Observação: Você deve fazer as alterações anteriores apenas quando testar o pacote de metadados. Você não deve fornecer aos usuários finais todas as ferramentas que fazem essas mudanças, e você não deve comunicar esses mecanismos de atuação aos usuários finais.

Depuração da instalação do pacote de metadados de dispositivoAs seções seguintes fornecem informações sobre como depurar a instalação do pacote de metadados de dispositivo.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 13: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 13

Verifique se o pacote de metadados do dispositivo está instalado.Verifique o ícone do dispositivo de destino em Dispositivos e Impressoras. Se o ícone que você especificou para o dispositivo está listado em Dispositivos e Impressoras, o pacote de metadados do dispositivo foi instalado corretamente pelo menos no que se refere à parte do DeviceInfo.xml.

Depurar as propriedades do contêiner de dispositivo usando Ddodiag.exe

Quando você depura um problema do pacote de metadados do dispositivo ou qualquer problema de propriedade do dispositivo, nós recomendamos que você use o Ddodiag.exe.

Desde o Windows 7, o Ddodiag.exe permite a listagem de todos os valores das propriedades do dispositivo nos contêineres de dispositivo.

Executar Ddodiag.exeSiga estas etapas para executar o Ddodiag.exe:

1. Inicie o prompt de comando.

2. Digite start /wait ddodiag.exe -o <Filename.xml> e pressione a tecla Enter.

3. Digite notepad.exe <Filename.xml>.

Observação: O xml inclui todas as propriedades dos contêineres de dispositivo no sistema. Se você está investigando determinado problema no dispositivo, encontre HardwareID ou ModelID no XML e veja as propriedades do contêiner de dispositivo. Se você está investigando se algum valor de propriedade está ou não definido, tente encontrar o valor no arquivo XML.

Exemplo 1: Quando você sabe as IDs de hardware do dispositivo de destino

1. Abra o filename.xml usando o Bloco de Notas ou qualquer editor.

2. Tente encontrar a ID de hardware (por exemplo, USB\VID_045E&amp;PID_0047).

3. Encontre o tipo de propriedade a seguir no arquivo XML:

<Property key="PKEY_Device_HardwareIds" type="VT_VECTOR | VT_LPWSTR" vectorCount="7">

<Value>USB\VID_045E&amp;PID_0047&amp;REV_0300</Value>

<Value>HID\VID_045E&amp;PID_0047&amp;REV_0300</Value>

<Value>USB\VID_045E&amp;PID_0047</Value>

<Value>HID\VID_045E&amp;PID_0047</Value>

<Value>HID_DEVICE_SYSTEM_MOUSE</Value>

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 14: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 14

<Value>HID_DEVICE_UP:0001_U:0002</Value>

<Value>HID_DEVICE</Value>

</Property>

4. O elemento de propriedade tem que ser um elemento filho de DDO. (ex. <DDO instanceId="DDO:{FF5614B9-6CB3-11E1-AAB0-806E6F6E6963}">).

5. No elemento DDO, veja as informações que você definiu no pacote de metadados do dispositivo. Quando os valores estão definidos, a instalação do pacote de metadados do dispositivo foi concluída corretamente.

Veja a seguir um exemplo dos valores de propriedade (nome do ícone):

<Property key="PKEY_DeviceDisplay_Icon" type="VT_LPWSTR"> <Value>%programdata%\microsoft\windows\devicemetadatacache\dmrccache\en-us\2ec2ef3b-83d2-4f5d-afa3-31aec5a379dd\DeviceInformation\IntelliMouseExplorer3.0.ico</Value>

</Property>

Exemplo 2: Quando você sabe os valores que devem estar definidos no contêiner1. Abra o filename.xml usando o bloco de notas ou qualquer editor.

2. Tente encontrar o valor (ex. Microsoft.Samples.PrinterExtensionCS).

3. Se você não encontrar nenhum, o valor não foi definido, então verifique as informações do pacote de metadados do dispositivo, como ID de hardware, assinatura do pacote, etc.

Veja a seguir um exemplo dos valores de propriedade (nome do pacote de um aplicativo):

<Property key="51236583-0c4a-4fe8-b81f-166aec13f510, 101" type="VT_VECTOR | VT_LPWSTR" vectorCount="1">

<Value>Microsoft.Samples.PrinterExtensionCS</Value>

</Property>

Depurar usando o ETW (Rastreamento de Eventos para Windows) no Windows 7

Se você depurar um problema do pacote de metadados do dispositivo, nós recomendamos que você use o Visualizador de Eventos.

Começando com o Windows 7, o serviço de Rastreamento de Eventos do Windows (ETW) suporta o canal DeviceMetadata/Debug para os eventos que estão relacionados ao processamento de pacote de metadados de dispositivos.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 15: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 15

Ver os eventos do ETW de Device Metadata/Debug no Visualizador de EventosSiga estas etapas para ver eventos de metadados de dispositivo no Visualizador de Eventos:1. No menu Iniciar, clique com o botão direito do mouse em Computador, e depois

selecione Gerenciar.2. Expanda o nó Ferramentas do Sistema.

3. Expanda e selecione o nó Visualizador de Eventos.4. No menu Exibir, clique em Mostrar Logs Analíticos e de Depuração.

5. Expanda o nó Logs de Aplicativos e Serviços node, expanda o nó Microsoft, expanda o nó Windows, e também o nó UserPnP.

6. Selecione o nó DeviceMetadata/Debug.Observação: Para receber e visualizar os eventos, você deve habilitar o registro no canal do ETW DeviceMetadata/Debug. Clique com o botão direito do mouse no nó DeviceMetadata/Debug, selecione Propriedades e marque a caixa EnableLogging.

Eventos do ETW de Device Metadata/DebugO sistema operacional registra o seguinte erro, como um aviso, e os eventos informativos durante o download ou o processamento de um pacote de metadados de dispositivo.

ID de evento: Erro 7900: erro no pacote de metadados de dispositivo.Foi detectado um erro com um dos componentes de um pacote de metadados de dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do erro.A origem do pacote de metadados de dispositivo, que é DeviceMetadataStore ou DeviceMetadataCache. Para saber mais, veja ”Glossário” posteriormente neste documento.

O nome do pacote de metadados do dispositivo. Um código de erro específico do aplicativo. Para saber mais sobre esses

códigos de erro, leia “Determinar o código de erro relacionado aos metadados do dispositivo” posteriormente neste documento.

Um código de erro Win32 .

ID de evento: Informação 7901: Pacote de metadados de dispositivo baixado do WMIS.Um pacote de metadados de dispositivo foi baixado do WMIS pelo DMRC, que extrai os componentes do pacote e os salva no cache de metadados dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do evento.

O local do pacote de metadados de dispositivo desempacotado no cacho dos metadados do dispositivo.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 16: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 16

O nome do pacote de metadados do dispositivo.

ID de evento: Erro 7902: Pacote de metadados de dispositivo não assinado.Um pacote de metadados de dispositivo instalado não foi assinado pelo Dashboard.

Observação: A assinatura do pacote de metadados de dispositivo é verificada somente quando é baixada do WMIS.

Esta mensagem de log de eventos contém as seguintes informações: Uma descrição do erro.

O nome do pacote de metadados do dispositivo. Um código de erro específico do aplicativo. Para saber mais sobre esses

códigos de erro, leia “Determinar o código de erro relacionado dos metadados do dispositivo” posteriormente neste documento.

Um código de erro Win32.

ID de evento: Informação 7950: Novo pacote de metadados de dispositivo descoberto no repositório de metadados local.O DMRC detectou um novo pacote de metadados de dispositivo que está instalado no computador local. Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do evento.

A origem do pacote de metadados de dispositivo, que é o Repositório de Metadados do Dispositivo ou o Cache de Metadados do Dispositivo. Para saber mais, veja ”Glossário” posteriormente neste documento.

O nome do pacote de metadados do dispositivo.

ID de evento: Informação 7951: Consulta para o pacote de metadados em progresso.O DMRC consulta o pacote de metadados de dispositivos instalado para um dispositivo específico. Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do evento. Uma chave de pesquisa do dispositivo, como a ID de hardware do dispositivo

ou ID do modelo.Observação: Apenas a identificação de hardware mais específica é registrada quando uma lista de IDs de hardware são aprovadascomo um parâmetro.

ID de evento: Aviso 7952: Erros relacionados à rede.O DMRC encontrou um erro de rede durante o download de um pacote de metadados de dispositivo do WMIS.

Observação: Este aviso não é gerado se a rede estiver indisponível.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 17: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 17

Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição detalhada do erro. Um código de erro específico do aplicativo.

O código do status do HTTP no momento do erro de rede.

Depurar usando o ETW (Rastreamento de Eventos para Windows) no Windows 8

Se você depurar um problema do pacote de metadados do dispositivo, nós recomendamos que você use o Visualizador de Eventos.

Começando com o Windows 7, o serviço de Rastreamento de Eventos do Windows (ETW) suporta o canal DeviceMetadata/Debug para os eventos que estão relacionados ao processamento de pacote de metadados de dispositivos.

Ver os eventos do ETW de Device Metadata/Debug no Visualizador de EventosSiga estas etapas para ver eventos de metadados de dispositivo no Visualizador de Eventos:

1. No menu Iniciar, digite Visualizador de Eventos e selecione as configurações no painel Pesquisar.

2. Clique em Exibir Logs de Eventos.

3. No menu Exibir, clique em Mostrar Logs Analíticos e de Depuração.

4. Expanda o nó Logs de Aplicativos e Serviços node, expanda o nó Microsoft, expanda o nó Windows, e também o nó UserPnP.

5. Selecione o nó DeviceMetadata/Debug.

Observação: Para receber e visualizar os eventos, você deve habilitar o registro no canal do ETW DeviceMetadata/Debug. Clique com o botão direito do mouse no nó DeviceMetadata/Debug, selecione Propriedades e marque a caixa EnableLogging.

Eventos do ETW de Device Metadata/DebugO sistema operacional registra os seguintes erros, avisos e eventos informativos durante o download ou o processamento de um pacote de metadados do dispositivo.

ID do Evento: Informação 7804: DMRC Começa Pesquisa no Índice Local.O DMRC começa a pesquisa de um pacote de metadados do dispositivo no cache Local.

Mensagem: INÍCIO: Pesquisando pacote de metadados no índice local

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 18: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 18

ID do Evento: Informação 7805: DMRC Para Pesquisa no Índice Local.O DMRC para de pesquisar um pacote de metadados do dispositivo no cache Local.

Mensagem: FIM: Pesquisando pacote de metadados no índice local

ID do Evento: Informação 7806: DMRC Começa a Descompactar Pacote.O DMRC começa a descompactar um pacote de metadados do dispositivo.

Mensagem: INÍCIO: Descompactando pacote de metadados em cache

ID do Evento: Informação 7807: DMRC Para de Descompactar Pacote.O DMRC para de descompactar um pacote de metadados do dispositivo.

Mensagem: FIM: Descompactando pacote de metadados em cache

ID do Evento: Informação 7808: DMRC Começa a Analisar_PackageInfo.O DMRC começa a analisar o packageinfo.xml.

Mensagem: INÍCIO: Analisando propriedades de metadados em packageinfo.xml

ID do Evento: Informação 7809: DMRC Para de Analisar_PackageInfo.O DMRC para de analisar o packageinfo.xml.

Mensagem: FIM: Analisando propriedades de metadados em packageinfo.xml

ID do Evento: Informação 7810: DMRC Começa a Examinar_RepositórioLocal.O DMRC começa a examinar os pacotes de metadados no repositório local de metadados.

Mensagem: INÍCIO: Examinando novos pacotes de metadados no repositório local

ID do Evento: Informação 7811: DMRC Para de Examinar_RepositórioLocal.O DMRC para de examinar os pacotes de metadados no repositório local de metadados.

Mensagem: FIM: Examinando novos pacotes de metadados no repositório local

ID do Evento: Informação 7812: DMRC Começa a Inicializar.O DMRC começa a inicializar o processo.

Mensagem: INÍCIO: inicializando o DMRC

ID do Evento: Informação 7813: DMRC Para de Inicializar.O DMRC para de inicializar.

Mensagem: FIM: inicializando o DMRC

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 19: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 19

ID do Evento: Informação 7814: DMRC Começa a Cancelar Inicialização.O DMRC começa a cancelar a inicialização.

Mensagem: INÍCIO: Cancelando inicialização do DMRC

ID do Evento: Informação 7815: DMRC Para de Cancelar Inicialização.O DMRC para de cancelar a inicialização.

Mensagem: FIM: Cancelando inicialização do DMRC

ID do Evento: Erro 7900: erro no pacote de metadados de dispositivo.Foi detectado um erro com um dos componentes de um pacote de metadados de dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do erro.A origem do pacote de metadados de dispositivo, que é DeviceMetadataStore ou DeviceMetadataCache. Para saber mais, veja ”Glossário” posteriormente neste documento.

O nome do pacote de metadados do dispositivo. Um código de erro específico do aplicativo. Para saber mais sobre esses

códigos de erro, leia “Determinar o código de erro relacionado aos metadados do dispositivo” posteriormente neste documento.

Um código de erro Win32® .0x50000011

Falha ao descompactar pacote de metadados Nome do pacote com falha na validação do nome de arquivo

0x50000021

Não foi possível abrir PackageInfo Não foi possível abrir DeviceInfo

Não foi possível abrir WindowsInfoNão foi possível abrir ServiceInfo

Não foi possível abrir SoftwareInfo

0x50000022Não foi possível analisar PackageInfo

Não foi possível analisar DeviceInfoNão foi possível analisar WindowsInfo

Não foi possível analisar ServiceInfoNão foi possível analisar SoftwareInfo

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 20: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 20

ID do Evento: Informação 7901: Pacote de metadados de dispositivo baixado do WMIS.Um pacote de metadados de dispositivo foi baixado do WMIS pelo DMRC, que extrai os componentes do pacote e os salva no cache de metadados dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: Um novo pacote de metadados do dispositivo foi baixado do WMIS.

O local do pacote de metadados do dispositivo descompactado no cache de metadados do dispositivo.

O nome do pacote de metadados do dispositivo.

ID de evento: Erro 7902: Pacote de metadados de dispositivo não assinado.Um pacote de metadados de dispositivo instalado não foi assinado pelo Dashboard.

Observação: A assinatura do pacote de metadados de dispositivo é verificada somente quando é baixada do WMIS.Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do erro. O nome do pacote de metadados do dispositivo.

Um código de erro específico do aplicativo. Para saber mais sobre esses códigos de erro, leia “Determinar o código de erro relacionado dos metadados do dispositivo” posteriormente neste documento.

Um código de erro Win32.

ID de evento: Informação 7903: DMRC Analisa Metadados do Dispositivo.O DMRC termina de analisar o pacote de metadados do dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: Arquivo de metadados do dispositivo analisado com êxito.

O local do pacote de metadados do dispositivo descompactado no cache de metadados do dispositivo.

O nome do pacote de metadados do dispositivo. Idioma

ID do Evento: Informação 7950: Novo pacote de metadados de dispositivo descoberto no repositório de metadados local.O DMRC detectou um novo pacote de metadados de dispositivo que está instalado no computador local. Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do evento. A origem do pacote de metadados de dispositivo, que é o Repositório de

Metadados do Dispositivo ou o Cache de Metadados do Dispositivo. Para saber mais, veja ”Glossário” posteriormente neste documento.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 21: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 21

O nome do pacote de metadados do dispositivo.

ID de evento: Informação 7951: Consulta para o pacote de metadados em progresso.O DMRC consulta o pacote de metadados de dispositivos instalado para um dispositivo específico. Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição do evento. Uma chave de pesquisa do dispositivo, como a ID de hardware do dispositivo

ou ID do modelo.Observação: Apenas a identificação de hardware mais específica é registrada quando uma lista de IDs de hardware são aprovadascomo um parâmetro.

ID de evento: Aviso 7952: Erros relacionados à rede.O DMRC encontrou um erro de rede durante o download de um pacote de metadados de dispositivo do WMIS.

Observação: Este aviso não é gerado se a rede estiver indisponível.

Esta mensagem de log de eventos contém as seguintes informações:

Uma descrição detalhada do erro. Um código de erro específico do aplicativo.

O código do status do HTTP no momento do erro de rede.

Depurar usando relatório de problemas (Centro de ação)O Windows 7 envia relatórios dos erros do pacote de dispositivos (código de erro 0x50000xx) para o servidor do Relatório de Erro do Windows (WER). O Centro de Ação lista os erros que serão enviados ou já foram enviados. Esses relatórios fornecem informações de depuração para o seu pacote de metadados de dispositivo.

Exibir um relatório de problemas no Centro de AçãoSiga estas etapas para ver um relatório de problemas no Centro de Ação:1. No menu Iniciar, digitar “Exibir relatórios de problemas” e pressione ENTER.

2. Selecione um relatório de problemas que você quer rever. O relatório contém informações detalhadas para o erro.

Você pode encontrar as mesmas informações no Visualizador de Eventos:1. Inicie o Visualizador de Eventos.

2. Expanda o nó Logs do Windows.

3. Clique com o botão direito do mouse em Aplicativo, e selecione Filtrar Log Atual.

4. Digite "1001” na caixa de texto ID do Evento e clique em OK.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 22: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 22

A caixa de texto ID do Evento é a caixa de texto sem rótulo no meio da caixa de diálogo com os conteúdos padrão de “<IDs de todos os eventos>”.

Interpretar um relatório de problemaTodo relatório de problema de Cliente de Recuperação de Metadados de Dispositivo contém as seguintes informações:1. Um código de erro específico do aplicativo. Para saber mais sobre esses códigos

de erro, veja “Determinar o código de erro relacionado aos metadados do dispositivo” posteriormente neste documento.

2. Um código de erro Win32.

3. A origem do pacote de metadados do dispositivo, que é o Repositório de Metadados do Dispositivo ou o Cache de Metadados do Dispositivo. Para saber mais, veja o “Glossário” posteriormente neste documento.

4. O nome do pacote de metadados do dispositivo.

Determinar o código de erro relacionado aos metadados do dispositivoComeçando com o Windows 7, o sistema operacional registra os seguintes códigos de erro dentro de eventos que estão relacionados com o download e processamento de pacotes de metadados de dispositivos. Estes eventos são gerenciados pelo serviço ETW e podem ser vistos usando o Visualizador de Eventos.

Erro de servidor WMIS (200000xx):

21: A solicitação não contém uma solicitação de metadados de dispositivo.22: O tamanho do lote solicitado excede o valor máximo permitido.

23: Valor local inválido.24: A solicitação não contém informações válidas de cabeçalho.

25: Formato solicitado inválido.31: O erro ocorreu no lado do serviço ao processar a solicitação.

Erro local de DMRC (0x400000xx):O cache local de metadados está corrompido:

11: Não há cache de metadados local.12: A estrutura (pastas) no cache de metadados local não está correta.

O repositório de metadados local está corrompido:21: Não há repositório de metadados local.22: A estrutura (pastas) no repositório de metadados local está corrompida.

O índice está corrompido:

31: O índice está ausente.32: O índice está corrompido.

Erros no pacote de metadados (0x500000xx):Erro no arquivo de gabinete:

11: O arquivo de gabinete está corrompido.12: O arquivo de gabinete não tem a estrutura correta.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 23: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 23

Erro PackageInfo.xml:21: PackageInfo.xml está ausente.22: PackageInfo.xml não está bem formado (não pode ser analisado).

Observação: O código de erro 22 indica que o documento PackageInfo.xml não tem elementos necessários ou um ou mais de seus elementos não são válidos com base na sintaxe do esquema PackageInfo XML.

Erro DeviceInfo.xml:31: DeviceInfo.xml está ausente32: DeviceInfo.xml não está bem formado (não pode ser analisado).33: DeviceInfo.xml não tem elementos necessários.34: Os elementos do DeviceInfo.xml não são válidos com base na definição de esquema XML.

Erro WindowsInfo.xml:41: WindowsInfo.xml está ausente.42: WindowsInfo.xml não está bem formado (não pode ser analisado).43: WindowsInfo.xml não tem elementos necessários.44: Os elementos em WindowsInfo.xml não são válidos com base na definição de esquema XML.

Erro de rede:Consulta de WMIS (0x70000xxx):

503: O servidor WMIS está ocupado e não pode atender à solicitação.Para mais informações sobre erros de HTTP, veja “Recursos” no final deste documento.

408: O servidor WMIS não falhou, mas a solicitação expirou.500: O servidor WMIS retornou um erro interno, mas a o XML com falha não tem um código de erro detalhado.

Erros de BITS:Para saber mais sobre erros BITS, veja "Valores de retorno de BITS" no MSDN®.

Apêndice

Depurar configuração do dispositivo usando o ETW (Rastreamento de Eventos para Windows) no Windows 8

Se você depurar um problema de configuração do dispositivo, incluindo a instalação do pacote de metadados do dispositivo, nós recomendamos que você use o Visualizador de Eventos.

Desde o Windows 8, o serviço ETW (Rastreamento de Eventos para Windows) permite o canal para eventos relacionados à configuração do dispositivo.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 24: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 24

Ver os eventos ETW de configuração do dispositivo no Visualizador de EventosSiga estas etapas para ver eventos de metadados do dispositivo no Visualizador de Eventos:1. No menu Iniciar, digite Visualizador de Eventos e selecione as configurações no

painel Pesquisar.2. Clique em Exibir Logs de Eventos.

3. No menu Exibir, clique em Mostrar Logs Analíticos e de Depuração.4. Expanda os nós Logs de Aplicativos e Serviços, Microsoft, Windows e

DeviceSetupManager.5. Selecione o nó Admin ou o nó Debug para ver os logs.

6. Observação: Para receber e ver eventos do nó Debug, habilite o registro em log no canal Debug. Clique com o botão direito do mouse no nó Debug, selecione Propriedades e marque a caixa chamada EnableLogging.

Eventos ETW de configuração do dispositivoO sistema operacional registra os seguintes erros, avisos e eventos informativos durante o download ou o processamento de um pacote de metadados do dispositivo.

Nó AdminVeja a seguir os eventos que são registrados no Nó Admin.

ID do Evento: Informação 100: DSMServiceStartup.O serviço de gerenciador de software do dispositivo é iniciado. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: Serviço DSM iniciado

Informações sobre o modoo Normal

o Em pausa

o Configuração

o Tela de apresentação

A hora em que a última sessão do DSM foi realizada.

ID do Evento: Informação 101: DSMServiceShutdown.O serviço de gerenciador de software do dispositivo é encerrado. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: Serviço DSM desligado.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 25: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 25

O tempo de ativação do serviço (por quanto tempo o serviço DSM ficou ativo).

O tempo de trabalho ativo (por quanto tempo o DSM trabalhou ativamente).

ID do Evento: Erro 104: DsmServiceStartupFailed.DSM não pôde ser inicializado. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O serviço DSM não pôde ser iniciado.

Código de erro Win32

ID do Evento: Informação 105: RetrySequenceStart.O DSM encontra um erro e começa a sequência de repetições. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O serviço DSM entra em uma sequência de repetições porque foram encontrados erros de software (que podem ser repetidos).

ID do Evento: Informação 106: RetrySequenceStop.O DSM sai da sequência de repetições. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O serviço DSM sai do estado de repetição

O tempo do ciclo de repetição nesta sessão. (Quantas vezes o DSM tentou ser repetido na sessão)

ID do Evento: Informação 109: DsmCoreServiceMode.O DSM entra no modo de serviço. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O serviço DSM entrou no modo de serviço

Informações sobre o modoo Normal

o Em pausa

o Configuração

o Tela de apresentação

ID do Evento: Informação 112: DeviceJobQueueComplete. O DSM completa a fila de trabalhos do dispositivo. Esta mensagem de log de

eventos contém as seguintes informações: Nome do Dispositivo

ID do Contêiner

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 26: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 26

O número de tarefas processadas nas sessões

O número de propriedades atualizadas O tempo de trabalho ativo (por quanto tempo o DSM trabalhou ativamente).

ID do Evento: Informação 120: DriverPackageDownloaded.O DSM baixou um driver do Windows Update. Esta mensagem de log de eventos

contém as seguintes informações: Mensagem: Atualização de driver baixada do Windows Update

ID do pacote de driver Tempo de download (quanto tempo levou para baixar os drivers).

ID do Evento: Erro 121: DriverInstallFailed.Falha na instalação do driver. Esta mensagem de log de eventos contém as

seguintes informações: Mensagem: Falha na instalação do driver

ID de Devnode Código de erro Win32

ID do Evento: Aviso 122: DriverInstallBlockedByWUPolicy.Falha na instalação do driver por causa da política de aceitação do WU. Política

de usuários ou grupo recusa o download do driver do WU. Mensagem: O acesso aos drivers no Windows Update foi bloqueado pela

política

ID do Evento: Aviso 123: DriverInstallDelayed.O serviço DSM foi atrasado. Esta mensagem de log de eventos contém as

seguintes informações:

Mensagem: O serviço DSM foi atrasado O tempo de atraso (duração do atraso. )

ID do Dispositivo

ID do Evento: Informação 124: DriverInstalled.O driver foi instalado com êxito. Esta mensagem de log de eventos contém as

seguintes informações:

ID do pacote de driver ID da instância do dispositivo

O tempo de instalação (quanto tempo levou para instalar o driver)

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 27: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 27

ID do Evento: Aviso 125: DriverInstallBlockedByPnpPolicy.Falha na instalação do driver por causa da política PnP. Esta mensagem de log de

eventos contém as seguintes informações: Mensagem: A instalação do driver no dispositivo foi bloqueada pela política

de restrição PnP ID de Devnode

ID do Evento: Aviso 130: MetadataStagingSucceeded.O pacote de metadados do dispositivo foi preparado para um contêiner de

dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O pacote de metadados foi preparado para o contêiner Nome do pacote de metadados do dispositivo

ID do contêiner de dispositivo Tempo de preparação (quanto tempo levou para preparar o pacote de

metadados do dispositivo)

ID do Evento: Erro 131: MetadataStagingFailed.Falha na preparação dos metadados. Esta mensagem de log de eventos contém

as seguintes informações:

Mensagem: Falha na preparação dos metadados ID do contêiner de dispositivo

Código de erro Win32

ID do Evento: Informação 150: DeviceRemovalSucceeded.O dispositivo foi removido com êxito. Esta mensagem de log de eventos contém

as seguintes informações:

Mensagem: O dispositivo foi removido. Nome do dispositivo

ID do Contêiner

ID do Evento: Erro 151: DeviceRemovalTimeout.O dispositivo não pode ser removido. Esta mensagem de log de eventos contém

as seguintes informações:

Mensagem: O dispositivo não pôde responder a uma solicitação de remoção de dispositivo.

Nome do dispositivo ID do Contêiner

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 28: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 28

ID do Evento: Erro 152: DevnodeRemovalFailure.O devnode não pode ser removido. Esta mensagem de log de eventos contém as

seguintes informações: Mensagem: Falha na remoção do nó do dispositivo.

Nome do devnode Código de erro

ID do Evento: Aviso 200: NoConnectionToWu.O sistema não tem conexão com o Windows Update.

Mensagem: Não foi possível estabelecer conexão com o serviço Windows Update.

ID do Evento: Aviso 201: NoConnectionToWmis.O sistema não tem conexão com os Serviços de Metadados e Internet do

Windows. Mensagem: Não foi possível estabelecer conexão com o WMIS (Serviços de

Metadados e Internet do Windows).

ID do Evento: Aviso 202: NoConnectionToInternet.O sistema não tem conexão com a Internet. Mensagem: O Gerenciador de Listas de Redes relata que não há

conectividade com a Internet.

ID do Evento: Informação 203: NetworkAvailable.O sistema não tem conexão com a Internet. Mensagem: O Gerenciador de Listas de Redes relata que não há

conectividade com a Internet.

Nó Debug

ID do Evento: Informação 102: DSMServiceDllLoad.Dll do serviço DSM carregada.

Mensagem: A dll do serviço DSM foi carregada.

ID do Evento: Informação 103: DSMServiceDllUnload.A dll do serviço DSM está sendo descarregada.

Mensagem: A dll do serviço DSM está sendo descarregada.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 29: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 29

ID do Evento: Informação 108: DsmCoreServiceState.O DSM entra no estado de serviço. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O serviço DSM entrou no estado de serviço

Informações do Estadoo Inicialização

o Ocioso

o Processando

o Repetição pendente

o Desligado

ID do Evento: Informação 110: DsmJobStarted.Trabalho do DSM iniciado no contêiner de dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O trabalho foi iniciado no contêiner de dispositivo ID do Contêiner

ID do Trabalho Modo do Trabalho

o StartDeviceInstall

o InstallDrivers

o RunHeuristics

o InstallMetadata

o Remover

o Atualizar

o RefreshProperty

ID do Evento: Informação 111: DsmJobComplete.O DSM completa um trabalho no contêiner de dispositivo. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: O trabalho foi concluído no contêiner de dispositivo

ID do Contêiner ID do Trabalho

Status da Tarefao Concluído

o Reinicialização Necessária

o Erro de Software

o Erro de Hardware

o Erro Interno

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 30: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 30

o Bloqueado pela política do usuário

o Bloqueado pela política do sistema

o Cancelado

ID do Evento: Informação 220: DsmRegisteredBackgroundTask.O DSM registrou uma tarefa em segundo plano no contêiner de dispositivo. Esta

mensagem de log de eventos contém as seguintes informações:

Mensagem: Manipulador registrado para o aplicativo manipular notificações pelo contêiner de dispositivo.

ID do contêiner de dispositivo Nome completo do pacote do aplicativo

Nome do manipulador de notificações

ID do Evento: Informação 221: DsmBackgroundTaskAlreadyRegistered.A tarefa em segundo plano já está registrada. Esta mensagem de log de eventos

contém as seguintes informações:

Mensagem: Já foi registrado um manipulador para o aplicativo no contêiner de dispositivo.

ID do contêiner de dispositivo Nome completo do pacote do aplicativo

ID do Evento: Informação 222: DsmRegisterErrorBackgroundTask.A tarefa em segundo plano não pôde ser registrada. A mensagem de log de eventos contém as seguintes informações:

Mensagem: O contêiner de dispositivo e o aplicativo especificam informações sobre tarefas em segundo plano, mas não foi possível registrar com erro.ID do contêiner de dispositivoNome completo do pacote do aplicativoCódigo de erro Win32

ID do Evento: Informação 223: DsmUnregisterPrintBackgroundTask.O registro de uma tarefa em segundo plano de impressão é cancelado após a

desinstalação do aplicativo. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: Registro cancelado da tarefa em segundo plano de Impressão após desinstalação do aplicativo.

Nome completo do pacote do aplicativo

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 31: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 31

ID do Evento: Informação 224: DsmUnregisterMobileOperatorBackgroundTask.O registro de uma tarefa em segundo plano de banda larga móvel é cancelado

após a desinstalação do aplicativo. Esta mensagem de log de eventos contém as seguintes informações:

Mensagem: Registro cancelado da tarefa em segundo plano da Operadora Móvel após desinstalação do aplicativo.

Nome completo do pacote do aplicativo

GlossárioDMRC

Cliente de Recuperação de Metadados de Dispositivo que gerencia a operação dos metadados no dispositivo no Windows 7.

WMISServiços de Internet e Metadados do Windows, que atende a pacotes de metadados de dispositivo que os parceiros enviam ao Dashboard pela Internet.

Dashboard de Hardware do Centro de Desenvolvimento do Windows Este é um site que permite que você qualifique dispositivos de hardware e aplicativos de software para o Programa do Logotipo Microsoft. Você pode fornecer informações sobre seus produtos nos sites de Listas de Produtos do Windows, bem como atualizar as definições de distribuição do driver no Windows Update, recuperar dados com problemas do usuário final e enviar o pacote de metadados de dispositivos.Para saber mais, veja Recursos no fim deste documento.

Repositório de Metadados do Dispositivo%programdata%\Microsoft\Windows\DeviceMetadataStore\

A pasta na qual os usuários ou aplicativos copiam o pacote de metadados de dispositivos ao instalar os pacotes no sistema local.

Cache de Metadados do Dispositivo%localappdata%\Local\Microsoft\Device Metadata\

%PROGRAMDATA%\Microsoft\Windows\DeviceMetadataStore (no Windows 8)

A pasta na qual o DMRC faz caches do pacote de metadados de dispositivo desempacotado. Todos os pacotes de metadados de dispositivos desempacotados como os pacotes de metadados de dispositivos que são baixados do WMIS ou do pacote de metadados de dispositivos que são instalados no Repositório de Metadados do Dispositivo Local são salvos nesta pasta.

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.

Page 32: Instalação do pacote de metadados do dispositivodownload.microsoft.com/download/4/8/5/4855007E-2900-446B... · Web viewPipeline de pacotes de metadados do dispositivo 28 de setembro

Pipeline de pacotes de metadados do dispositivo - 32

Recursos

MSDNValores de retorno de BITS

http://msdn.microsoft.com/en-us/library/aa362823(VS.85).aspx

Função CopyFilehttp://msdn2.microsoft.com/en-us/library/aa363851.aspx

Site do Centro de Desenvolvimento do Windows-HardwareComo criar um pacote de metadados de dispositivo para dispositivos e impressoras

http://msdn.microsoft.com/en-us/library/windows/hardware/gg463145.aspx

Kit de Driver do WindowsInstalação de dispositivo e driver

http://msdn2.microsoft.com/en-us/library/aa972910.aspxCriando arquivos INF para várias plataformas e sistemas operacionais

http://msdn.microsoft.com/en-us/library/ff540206.aspxArquivos INF

http://msdn.microsoft.com/en-us/library/ff547402.aspx10 definições de código de status

http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10

28 de setembro de 2012© 2012 Microsoft Corporation. Todos os direitos reservados.