MediaProvider.BeginSdpRenegotiation Method

Reference

Definition

Namespace:: Microsoft.Rtc.Collaboration.ComponentModel

Assembly:: Microsoft.Rtc.Collaboration.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Begins SDP renegotiation for a given callDialog.

protected:
 IAsyncResult ^ BeginSdpRenegotiation(Microsoft::Rtc::Collaboration::CallDialogContext ^ callDialog, AsyncCallback ^ userCallback, System::Object ^ state);

protected IAsyncResult BeginSdpRenegotiation (Microsoft.Rtc.Collaboration.CallDialogContext callDialog, AsyncCallback userCallback, object state);

member this.BeginSdpRenegotiation : Microsoft.Rtc.Collaboration.CallDialogContext * AsyncCallback * obj -> IAsyncResult

Protected Function BeginSdpRenegotiation (callDialog As CallDialogContext, userCallback As AsyncCallback, state As Object) As IAsyncResult

Parameters

callDialog: CallDialogContext

SignalingContext for the corresponding call dialog.

userCallback: AsyncCallback

The method to be called when the asynchronous operation is completed.

state: Object

A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.

Returns

IAsyncResult

An IAsyncResult that references the asynchronous operation.

Exceptions

ArgumentNullException

Thrown when callDialog is null.

InvalidOperationException

Thrown when callDialog contains a dialog, which can not be renegotiated, typical example is MediaProvider is trying to renegotiate an early dialog after dialog is confirmed.

Remarks

If any incoming SDP renegotiation is in progress when this method is being invoked, the requested SDP renegotiation will begin after the pending renegotiation is finished.

MediaProvider should expect that the BeginGetOffer method will be called after BeginSdpRenegotiation has started.

Applies to