ServiceDevice Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 ServiceDevicePublic Class ServiceDevice- Inheritance
- Attributes
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. |