Share via

IRenderingControl::SelectPreset (Windows Embedded CE 6.0)

  • Article

1/6/2010

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 AV DCP Documentation.

Requirements

Header av_upnp.h
Library Av_upnp.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IRenderingControl
UPnPAVError