IRenderingControl::SelectPreset (Compact 7)

  • Article

3/12/2014

This method uses the specified preset to restore a subset of this RenderingControl instance's state variables to the values associated with the preset.

Syntax

virtual DWORD SelectPreset(
  LPCWSTR pszPresetName
) = 0;

Parameters

  • pszPresetName
    [in] Name of the preset to be used to update the state variables. Corresponds to the A_ARG_TYPE_PresetName state variable.

Return Value

Custom implementations can return appropriate error codes. Should return SUCCESS_AV if the method succeeds. Otherwise, should return an error code defined in WinError.h or UPnP.h, or one of the UPnP AV-specific return values specified in UPnPAVError, especially the following errors documented for this action in the RenderingControl DCP documentation:

  • ERROR_AV_UPNP_ACTION_FAILED
  • ERROR_AV_UPNP_RC_INVALID_PRESET_NAME
  • ERROR_AV_UPNP_RC_INVALID_INSTANCE_ID

Remarks

This method corresponds to the RenderingControl service's SelectPreset action.

For more information about the actions in the RenderingControl service, see UPnP Forum AV Web site.

Requirements

Header

av_upnp.h

Library

Av_upnp.lib

See Also

Reference

IRenderingControl
UPnPAVError