Partager via

IWSDDeviceProxy (Compact 2013)

  • Article

3/26/2014

This interface represents a remote DPWS device for client applications and middleware. To get this interface, call WSDCreateDeviceProxy.

The IWSDDeviceProxy interface inherits the methods of the IUnknown interface.

In addition, the following table lists the methods supported by the IWSDDeviceProxy interface in vtable order.

Method

Description

IWSDDeviceProxy::Init

Initializes the device proxy, optionally sharing a session with a previously initialized sponsoring device proxy.

IWSDDeviceProxy::BeginGetMetadata

Sends an asynchronous request for metadata.

IWSDDeviceProxy::EndGetMetadata

Ends an asynchronous request for metadata and returns the metadata related to a device.

IWSDDeviceProxy::GetHostMetadata

Gets class-specific metadata for the device describing the features of the device and the services it hosts.

IWSDDeviceProxy::GetThisModelMetadata

Gets model-specific metadata for the device.

IWSDDeviceProxy::GetThisDeviceMetadata

Gets device-specific metadata for this device.

IWSDDeviceProxy::GetAllMetadata

Gets all metadata for this device.

IWSDDeviceProxy::GetServiceProxyById

Gets a generic IWSDServiceProxy service proxy by service ID. Service IDs can be obtained by examining the service host metadata.

IWSDDeviceProxy::GetServiceProxyByType

Gets a generic IWSDServiceProxy proxy for a service exposed by the device by port type name.

IWSDDeviceProxy::GetEndpointProxy

Gets the endpoint proxy for the device.

Remarks

This interface is a client-side representation of a remote device. The proxy provides basic access to device metadata (WSD_THIS_DEVICE_METADATA and WSD_THIS_MODEL_METADATA), in addition to providing methods for creating service proxy objects. The service proxy objects correspond to service hosted on the device. For example, a television is a device and the tuner portion of the television is a service hosted on the device that has an accessible, atomic set of functions.

The IWSDDeviceProxy object exposes WSD-specific device semantics. To use IWSDDeviceProxy in a client or middleware application, take the following action:

  1. Call WSDCreateDeviceProxy.
  2. Call any of the four metadata methods of the device proxy object.
  3. Get an IWSDServiceProxy object, either by calling GetServiceProxyById or GetServiceProxyByType.

Requirements

Header

wsdapi.h

Library

wsdapi.lib

See Also

Reference

Web Services on Devices Interfaces
Web Services on Devices Reference