Aplicativos de dispositivo UWP para dispositivos internos
Este tópico apresenta como os aplicativos de dispositivo UWP podem acessar dispositivos internos. Dispositivos internos são aqueles que residem dentro ou estão integrados ao gabinete do PC.
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:
| Recomendado? | API | Developer | Os metadados do dispositivo são necessários? |
|---|---|---|---|
| Sim | APIs de cenário de dispositivo (captura de imagem, digitalização, etc.) | todos os desenvolvedores | não |
| Sim | APIs de protocolo de dispositivo (USB, HID, etc.) | OEM | sim (apenas para dispositivos internos) |
| Não | Acesso de driver personalizado | OEM | sim |
APIs de cenário de dispositivo
O Windows Runtime fornece várias APIs para acessar dispositivos comuns que são internos ou estão conectados ao computador, como APIs para captura de imagens, digitalização, impressão e uso de sensores de movimento. Como essas APIs foram desenvolvidas 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. Para obter mais informações sobre APIs de cenário, consulte Integrando dispositivos.
Qualquer acesso além do que as APIs de cenário de dispositivo oferecem é limitado a OEMs (ou fornecedores de componentes, trabalhando em conjunto 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 é satisfeita pelas APIs de cenário, ele pode usar as APIs de protocolo de dispositivo. As APIs de protocolo de dispositivo são APIs do Windows Runtime que os aplicativos UWP podem usar para acessar USB e dispositivos de interface humana (HID). O tipo de acesso varia de acordo com a API.
| API de protocolo de dispositivo | Namespace | Tipo de acesso |
|---|---|---|
| USB | Windows.Devices.Usb | leitura exclusiva e 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 de dispositivo), os metadados do dispositivo não são necessários. No entanto, para acessar dispositivos internos com essas APIs, os 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. Esses requisitos restringem o acesso de dispositivos internos aos OEMs.
Para saber mais, veja:
Requisitos do driver de dispositivo (a partir da etapa 1 do guia passo a passo)
Criando metadados de dispositivo (etapa 2 do guia passo a passo)
Acesso de driver personalizado
Quando OEMs ou IHVs não puderem 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 ao driver personalizado 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 ao driver personalizado, consulte Guia de design de aplicativos de dispositivo UWP para dispositivos especializados internos ao computador.
Fornecedores de componentes
Os fornecedores de componentes podem trabalhar com os OEMs para desenvolver aplicativos de dispositivo UWP para seus dispositivos internos. Isso pode acontecer de duas 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 possui os 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. Por fim, o OEM é proprietário do desenvolvimento de aplicativos, da distribuição de aplicativos e da 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 Guia de design de aplicativos de dispositivo UWP para dispositivos especializados internos ao computador.
Tópicos relacionados
Identificando a localização de câmeras internas (aplicativos de dispositivo UWP)