IRenderingControl::SelectPreset
A version of this page is also available for
4/8/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 |
| Windows Mobile | Windows Mobile Version 5.0 and later |