Share via


IRTCSession::AddStream (Windows Embedded CE 6.0)

1/6/2010

This method adds one new stream to this session. The session must be in the RTCSS_CONNECTED or RTCSS_INPROGRESS state. The call starts a renegotiation with the other end of the call, and an RTCE_SESSION_STATE_CHANGE event is triggered.

Syntax

HRESULT AddStream(
  long lMediaType,
  LONG_PTR lCookie
);

Parameters

  • lMediaType
    [in] An RTCMT_ constant specifying the media for which the stream will be added. The application can add only one stream at a time.

    Windows Embedded CE does not support RTCMT_VIDEO_SEND, RTCMT_VIDEO_RECEIVE and RTCMT_T120_SENDRECV media types.

  • lCookie
    [in] Pointer to an application-provided cookie used in the completion notification.

Return Value

This method can return an RTC_E_ constant.

The following table shows additional information about specific return values.

Value Description

RTC_E_INVALID_SESSION_STATE

Session must be connected or in progress.

RTC_E_INVALID_SESSION_TYPE

Session must be PC-to-PC or PC-to-phone.

Remarks

This method will add a media type to the list of preferred media types specified in the call to IRTCClient::SetPreferredMediaTypes.

Ee500106.security(en-US,WinEmbedded.60).gifSecurity Note:
This method can send media such as audio or video over the network in unencrypted form. Therefore, someone eavesdropping on the network might be able to render the media. Before using this method in an unencrypted session, consider the security risk of sending this media stream.

Requirements

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

See Also

Reference

IRTCSession
IRTCClient::SetPreferredMediaTypes
IRTCSession::RemoveStream