ServiceDevice Class

  • Reference

Definition

Namespace:
Windows.Devices.Portable
Edit

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

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
Inheritance
Object Platform::Object IInspectable ServiceDevice
Attributes
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Device family
Windows Desktop Extension SDK (introduced in 10.0.10240.0)
API contract
Windows.Devices.Portable.PortableDeviceContract (introduced in v1.0)

Remarks

To access these services, you must declare the device service in the device capabilities section of the app manifest file. For a list of the GUIDs representing the device services, see Windows.Devices.Portable. 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 Microsoft Store device apps given privileged access to a device by the device manufacturer. For more information about Microsoft Store device apps, see Windows 8 Device Experience: .

Methods

GetDeviceSelector(ServiceDeviceType)

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(Guid)

An Advanced Query Syntax (AQS) string for identifying a device service by its GUIDs. This string is passed to the FindAllAsync or CreateWatcher method.

Applies to

See also