Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ServiceDevice class

Applies to Windows only

Provides methods for identifying a device service for a portable device that supports WPD (Windows Portable Devices) for device enumeration.

Syntax


public ref class ServiceDevice abstract sealed 

Attributes

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Members

The ServiceDevice class has these types of members:

Methods

The ServiceDevice class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

MethodDescription
GetDeviceSelector Returns an Advanced Query Syntax (AQS) string that is used to enumerate device services of the specified ServiceDeviceType. This string is passed to the FindAllAsync or CreateWatcher method.
GetDeviceSelectorFromServiceId An Advanced Query Syntax (AQS) string for identifying a device service by its GUIDs. This string is passed to the FindAllAsync or CreateWatcher method.

 

Remarks

To access the device services, you must declare the device service in the capabilities section of the app manifest file. For a list of the GUIDs representing the device services, see Windows.Devices.Portable.

The GetDeviceSelector and GetDeviceSelectorFromServiceId methods get selector strings that are passed to the Windows.Devices.Enumeration API to find portable device services. The Enumerating Common Devices tutorial explains how to use selector strings to discover available devices.

Examples of device services are the Media Transfer Protocol (MTP) device services that allow access to device status, contacts, calendar, tasks, and ringtones on a device. For more information, see MTP Device Services for Windows.

The Portable Device Services Sample demonstrates how to access the device service once you have discovered it.

Note  Access to a device service using this API is only available to Windows Store device apps given privileged access to a device by the device manufacturer. For more information about Windows Store device apps, see Windows 8 Device Experience: Windows Store device apps.

Requirements

Minimum supported client

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

None supported

Namespace

Windows.Devices.Portable
Windows::Devices::Portable [C++]

Metadata

Windows.winmd

See also

Concepts
Windows 8 Device Experience: Windows Store device apps
Samples
Portable Device Services Sample
Tutorials
Enumerating Common Devices

 

 

Show:
© 2014 Microsoft