IRTCSession::AddStream

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

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.

Remarks

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

Security 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

See Also

Reference

IRTCSession
IRTCClient::SetPreferredMediaTypes
IRTCSession::RemoveStream