Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method sets the current volume, in units of 1/256 of a decibel, for the specified channel in this RenderingControl instance.

Syntax

virtual DWORD SetVolumeDB(
  LPCWSTR 
pszChannel,
  short 
VolumeDB
) = 0;

Parameters

pszChannel

[in] Audio channel to set. For example, Master, LF (left front), RF (right front), and so on. Corresponds to the A_ARG_TYPE_Channel state variable.

VolumeDB

[in] Decibel volume setting for the specified channel in this RenderingControl instance. Each increment is 1/256th of a decibel. You can retrieve the range of allowed values using IRenderingControl::GetVolumeDBRange. Corresponds to the VolumeDB 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_INSTANCE_ID

Remarks

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

The RenderingControl service does not require that this method be implemented. The IRenderingControlImplclass therefore overrides this method to return ERROR_AV_UPNP_INVALID_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

See Also