IAVTransport::SetRecordQualityMode (Compact 7)

3/12/2014

This method sets the record quality for this AVTransport instance.

Syntax

virtual DWORD SetRecordQualityMode(
  LPCWSTR pszNewRecordQualityMode
) = 0;

Parameters

  • pszNewRecordQualityMode
    [in] Record quality mode. Corresponds to the CurrentRecordQualityMode state variable. Possible record quality modes are stored in the PossibleRecordQualityModes 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 AVTransport DCP documentation:

  • ERROR_AV_UPNP_AVT_TRANSPORT_LOCKED
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_REC_QUALITY
  • ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID

Remarks

This method corresponds to the AVTransport service's SetRecordQualityMode action.

The AVTransport service does not require that this method be implemented. The IAVTransportImpl class therefore overrides this method to return ERROR_AV_UPNP_INVALID_ACTION.

Requirements

Header

av_upnp.h

Library

Av_upnp.lib

See Also

Reference

IAVTransport
UPnPAVError