IRenderingControl::SelectPreset (Windows Embedded CE 6.0)

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

See Also

Reference

IRenderingControl
UPnPAVError