ServiceDevice Classe

Definição

Namespace:

Windows.Devices.Portable

Fornece métodos para identificar um serviço de dispositivo para um dispositivo portátil que dá suporte a WPD (Dispositivos Portáteis do Windows) para enumeração de dispositivo.

public ref class ServiceDevice abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Portable.PortableDeviceContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ServiceDevice final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Portable.PortableDeviceContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class ServiceDevice

Public Class ServiceDevice

Herança

Object Platform::Object IInspectable ServiceDevice

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
API contract	Windows.Devices.Portable.PortableDeviceContract (introduzida na v1.0)

Comentários

Para acessar esses serviços, você deve declarar o serviço de dispositivo na seção funcionalidades do dispositivo do arquivo de manifesto do aplicativo. Para obter uma lista dos GUIDs que representam os serviços de dispositivo, consulte Windows.Devices.Portable. Para acessar os serviços de dispositivo, você deve declarar o serviço de dispositivo na seção funcionalidades do arquivo de manifesto do aplicativo. Para obter uma lista dos GUIDs que representam os serviços de dispositivo, consulte Windows.Devices.Portable.

Os métodos GetDeviceSelector e GetDeviceSelectorFromServiceId obtêm cadeias de caracteres de seletor que são passadas para a API Windows.Devices.Enumeration para localizar serviços de dispositivo portáteis. O tutorial Enumerando Dispositivos Comuns explica como usar cadeias de caracteres de seletor para descobrir dispositivos disponíveis.

Exemplos de serviços de dispositivo são os serviços de dispositivo MTP (Protocolo de Transferência de Mídia) que permitem acesso a dispositivos status, contatos, calendário, tarefas e toques em um dispositivo. Para obter mais informações, confira Serviços de Dispositivos MTP para Windows.

O Exemplo de Serviços de Dispositivo Portátil demonstra como acessar o serviço de dispositivo depois de descobri-lo.

Observação

O acesso a um serviço de dispositivo usando essa API só está disponível para aplicativos de dispositivo da Microsoft Store com acesso privilegiado a um dispositivo pelo fabricante do dispositivo. Para obter mais informações sobre aplicativos de dispositivo da Microsoft Store, consulte Experiência do dispositivo Windows 8: .

Métodos

GetDeviceSelector(ServiceDeviceType)	Retorna uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) usada para enumerar serviços de dispositivo do ServiceDeviceType especificado. Essa cadeia de caracteres é passada para o método FindAllAsync ou CreateWatcher .
GetDeviceSelectorFromServiceId(Guid)	Uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) para identificar um serviço de dispositivo por seus GUIDs. Essa cadeia de caracteres é passada para o método FindAllAsync ou CreateWatcher .

Confira também

• Experiência do dispositivo Windows 8:
• Amostra de Serviços de Dispositivo Portátil
• Enumerando dispositivos comuns