Partilhar via


Aplicativos de dispositivo UWP para dispositivos internos

Important

Os metadados do dispositivo foram preteridos e serão removidos em uma versão futura do Windows. Para obter informações sobre a substituição dessa funcionalidade, consulte Metadados do contêiner do pacote de driver.

Este tópico apresenta as maneiras pelas quais os aplicativos de dispositivo UWP podem acessar dispositivos internos. Internal devices are devices that reside inside or are integrated with the PC enclosure.

Algumas APIs mencionadas neste tópico também podem ser usadas para acessar dispositivos externos. Este tópico se concentra especificamente no acesso a dispositivos internos. Para obter mais informações sobre cada API, consulte a referência da API do Windows.

Acesso a dispositivos internos

Há três maneiras pelas quais os aplicativos UWP podem acessar dispositivos internos:

Recommended? API Desenvolvedor Os metadados do dispositivo são necessários?
Yes APIs de cenário de dispositivo (captura de imagem, digitalização, etc.) all developers no
Yes APIs de protocolo de dispositivo (USB, HID, etc.) OEM Sim (apenas para dispositivos internos)
No Acesso personalizado ao controlador OEM yes

APIs de cenário de dispositivo

O Tempo de Execução do Windows fornece várias APIs para acessar dispositivos comuns internos ou conectados ao computador, como APIs para captura de imagem, digitalização, impressão e uso de sensores de movimento. Como essas APIs são projetadas com um cenário específico em mente, elas são chamadas de APIs de cenário de dispositivo. As APIs de cenário de dispositivo podem ser usadas por todos os desenvolvedores e nenhum metadados de dispositivo é necessário para usá-las. For more info about scenario APIs, see Integrating devices.

Qualquer acesso além do que as APIs de cenário de dispositivo oferecem é limitado a OEMs (ou fornecedores de componentes, trabalhando em coordenação com OEMs) e requer metadados de dispositivo para o contêiner do sistema.

APIs de protocolo de dispositivo

Quando um fornecedor de OEM/componente precisa acessar um dispositivo interno de uma forma que não é satisfeita pelas APIs do cenário, ele pode usar as APIs de protocolo de dispositivo. As APIs de protocolo de dispositivos são APIs do Windows Runtime que os aplicativos UWP podem usar para acessar dispositivos USB e dispositivos de interface humana (HID). O tipo de acesso varia de acordo com a API.

API de protocolo de dispositivo Namespace Access type
USB Windows.Devices.Usb leitura exclusiva & escrita exclusiva
HID Windows.Devices.HumanInterfaceDevice leitura compartilhada e escrita exclusiva

Para acessar dispositivos periféricos que usam apenas drivers de classe Microsoft - o uso mais comum para as APIs de protocolo de dispositivo - os metadados do dispositivo não são necessários. No entanto, para acessar dispositivos internos com essas APIs, são necessários metadados. Ao acessar um dispositivo interno, o aplicativo deve ser especificado nos metadados do dispositivo como um aplicativo privilegiado para o contêiner do sistema. Este requisito restringe o acesso de dispositivos internos aos OEMs.

Para mais informações, consulte:

Acesso personalizado ao controlador

Quando os OEMs ou IHVs não conseguem usar as APIs de protocolo de dispositivo para acessar seu dispositivo (interno ou periférico), eles devem primeiro entrar em contato com a Microsoft para discutir seu cenário com a equipe do Ecossistema do Windows. Em alguns casos, mediante aprovação da Microsoft, um aplicativo de dispositivo UWP pode acessar diretamente um driver personalizado.

O acesso personalizado ao driver requer metadados do dispositivo. Para acessar um driver personalizado, o aplicativo deve ser especificado nos metadados do dispositivo como um aplicativo privilegiado para o dispositivo periférico ou contêiner do sistema. Para saber mais sobre o acesso de driver personalizado, veja Guia de design de aplicações de dispositivo UWP para dispositivos especializados internos no PC.

Component suppliers

Os fornecedores de componentes podem trabalhar com OEMs para desenvolver aplicativos de dispositivo UWP para seus dispositivos internos. Isso pode acontecer de duas maneiras:

  • O fornecedor do componente desenvolve e distribui o aplicativo: neste caso, o fornecedor do componente possui, desenvolve e distribui o aplicativo e o driver que acessa o dispositivo interno. O OEM é o proprietário dos metadados do dispositivo.

  • O OEM desenvolve e distribui o aplicativo: Neste caso, o OEM desenvolve e distribui o aplicativo que acessa um ou mais dispositivos internos de diferentes fornecedores de componentes. Em última análise, o OEM é o proprietário do desenvolvimento de aplicativos, distribuição de aplicativos e manutenção de metadados de dispositivos. O fornecedor de componentes é o proprietário do motorista.

Para saber mais sobre esses fluxos de trabalho, veja Guia de design de aplicativos de dispositivo UWP para dispositivos especializados internos ao PC.