IRTCClient2 (Windows Embedded CE 6.0)

1/6/2010

This interface contains additional methods and properties for the Client object. It extends the IRTCClient interface.

Methods

The following table shows the methods for this interface in vtable order. This is the order in which the compiler calls the methods. This interface inherits the methods for the IUnknown and IRTCClient interfaces.

The following table shows the IRTCClient methods.

Method	Description
IRTCClient::Initialize	Initializes the Client object.
IRTCClient::Shutdown	Cleans up the Client object.
IRTCClient::PrepareForShutdown	Asynchronously prepares the client for shutting down.
IRTCClient::EventFilter	Sets or gets the event filter that is used for all attached event sinks.
IRTCClient::SetPreferredMediaTypes	Sets the preferred media types for new sessions.
IRTCClient::PreferredMediaTypes	Gets the preferred media types for new sessions.
IRTCClient::MediaCapabilities	Gets the media types supported by the current hardware.
IRTCClient::CreateSession	Creates a session.
IRTCClient::ListenForIncomingSessions	Sets or gets the listening mode that the client uses for incoming sessions.
IRTCClient::NetworkAddresses	Gets the IP addresses and ports on which the client is listening.
IRTCClient::Volume	Sets or gets the volume on an audio device.
IRTCClient::AudioMuted	Sets or gets the muting on an audio device.
IRTCClient::IVideoWindow	This method is not supported in Windows Embedded CE.
IRTCClient::PreferredAudioDevice	Sets or gets the preferred audio device for audio capturing or rendering.
IRTCClient::PreferredVolume	Sets or gets the preferred volume on an audio device.
IRTCClient::PreferredVideoDevice	This method is not supported in Windows Embedded CE.
IRTCClient::ActiveMedia	Gets the media types for currently active streams in a session.
IRTCClient::MaxBitrate	Sets or gets the maximum bit rate (bps) for a session.
IRTCClient::TemporalSpatialTradeOff	Sets or gets the temporal-spatial tradeoff for a session.
IRTCClient::NetworkQuality	Gets the quality value of the network connection.
IRTCClient::StartT120Applet	This method is not supported in Windows Embedded CE.
IRTCClient::StopT120Applets	This method is not supported in Windows Embedded CE.
IRTCClient::IsT120AppletRunning	This method is not supported in Windows Embedded CE.
IRTCClient::LocalUserURI	Sets or gets the SIP URI used in the From: header of the messages sent from the client.
IRTCClient::LocalUserName	Sets or gets the displayable name used in the From: header of the messages sent from the client.
IRTCClient::PlayRing	Plays a ring on the operating system default audio device or on the RTC default audio device.
IRTCClient::SendDTMF	Sends a Dual-Tone Multi-Frequency (DTMF) tone to the active session and plays a feedback tone to the RTC default audio device.
IRTCClient::InvokeTuningWizard	This method is not supported in Windows Embedded CE.
IRTCClient::IsTuned	Gets the tuning status of the tuning wizard.

The following table shows the IRTCClient2 methods.

Method	Description
IRTCClient2::AllowedPorts	Sets or gets the ports the client uses to listen for incoming sessions.
IRTCClient2::AnswerMode	Sets or gets the answer mode for a session type.
IRTCClient2::InvokeTuningWizardEx	This method is not supported in Windows Embedded CE.
IRTCClient2::Version	Gets the version of the client.
IRTCClient2::ClientName	Sets the name of the application that is used in the User-Agent header.
IRTCClient2::ClientCurVer	Sets the version of the application for the User-Agent header.
IRTCClient2::InitializeEx	Specifies additional information about the mode of initialization, such as disabling for the media stack or UPnP support.
IRTCClient2::CreateSessionWithDescription	Creates a session and specifies that the application is responsible for all negotiations with the session.
IRTCClient2::SetSessionDescriptionManager	Sets the application's Session Description Manager that handles session negotiations.
IRTCClient2::PreferredSecurityLevel	Sets or gets the encryption level for each media type required for the session.

Obtaining a Pointer

The application can obtain the client object using CoCreateInstance for CLSID_RTCClient (GUID = {7a42ea29-a2b7-40c4-b091-f6f024aa89be}). The RTC client object can be subsequently queried for the presence of IRTCClient2 using IUnknown::QueryInterface.

The object can be used as an inproc server only.

Requirements

Header	rtccore.h, rtccore.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

RTC Client API Interfaces