Compartilhar via


Aplicativos de dispositivo UWP para dispositivos internos

Important

Os metadados do dispositivo foram preteridos e serão removidos numa versão futura do Windows. Para obter informações sobre a substituição dessa funcionalidade, consulte Metadados de 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.

Acessando 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 (somente para dispositivos internos)
No Acesso personalizado ao driver OEM yes

APIs de cenários de uso de dispositivo

O Windows Runtime fornece várias APIs para acessar dispositivos comuns que são internos ou anexados ao computador, como APIs para captura de imagem, verificaçã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 conhecidas como APIs de cenário de dispositivo. As APIs de cenário de dispositivo podem ser usadas por todos os desenvolvedores e nenhum metadado de dispositivo é necessário para usá-las. For more info about scenario APIs, see Integrating devices.

Qualquer acesso além do que as APIs do 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 maneira que não seja atendida pelas APIs de cenário, ele pode usar as APIs de protocolo do dispositivo. As APIs de protocolo de dispositivo são APIs do Windows Runtime que os aplicativos UWP podem usar para acessar dispositivos USB e 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 & gravação exclusiva
HID Windows.Devices.HumanInterfaceDevice leitura compartilhada e gravação exclusiva

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

Consulte mais informações em:

Acesso personalizado ao driver

Quando os OEMs ou IHVs não conseguem usar as APIs de protocolo do 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 Windows Ecosystem. Em alguns casos , após a 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 obter mais informações sobre o acesso personalizado ao driver, consulte o guia de design de aplicativos de dispositivo UWP para dispositivos internos especializados ao computador.

Component suppliers

Os fornecedores de componentes podem trabalhar com OEMs para desenvolver aplicativos de dispositivo UWP para seu dispositivo interno. Isso pode acontecer de algumas maneiras:

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

  • O OEM desenvolve e distribui o aplicativo: nesse caso, o OEM desenvolve e distribui o aplicativo que acessa um ou mais dispositivos internos de diferentes fornecedores de componentes. O OEM, em última análise, possui o desenvolvimento de aplicativos, a distribuição de aplicativos e a manutenção de metadados do dispositivo. O fornecedor do componente é o proprietário do driver.

Para obter mais informações sobre esses fluxos de trabalho, consulte o guia de design de aplicativos de dispositivo UWP para dispositivos especializados internos para o computador.