IRTCSession::AddStream

  • Article

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

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 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 Values

This method can return an RTC_E_ constant. The following table shows the possible 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.

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

IRTCSession::RemoveStream

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.