Begins SDP renegotiation for a given callDialog.

Namespace:  Microsoft.Rtc.Collaboration.ComponentModel
Assembly:  Microsoft.Rtc.Collaboration(in Microsoft.Rtc.Collaboration.dll)

Syntax

Visual Basic (Declaration) 
Protected 
Function 
BeginSdpRenegotiation ( _
	
signalingContext 
As 

CallDialogContext, _
	
userCallback 
As 
AsyncCallback, _
	
state 
As 
Object _
) 
As 
IAsyncResult
C# 
protected 
IAsyncResult 
BeginSdpRenegotiation(
	

CallDialogContext 
signalingContext,
	
AsyncCallback 
userCallback,
	
Object 
state
)
Visual C++ 
protected:
IAsyncResult^ 
BeginSdpRenegotiation(
	

CallDialogContext^ 
signalingContext, 
	
AsyncCallback^ 
userCallback, 
	
Object^ 
state
)
JavaScript 
function 
beginSdpRenegotiation(
signalingContext, 
userCallback, 
state);

Parameters

signalingContext
Type: Microsoft.Rtc.Collaboration . . :: . CallDialogContext
SignalingContext for the corresponding call dialog.
userCallback
Type: AsyncCallback
The method to be called when the asynchronous operation is completed.
state
Type: Object
A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.

Return Value

An IAsyncResult that references the asynchronous operation.

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.

Exceptions

Exception Condition
ArgumentNullException Thrown when signalingContextis null.
InvalidOperationException Thrown when signalingContextcontains a dialog, which can not be renegotiated, typical example is MediaProvider is trying to renegotiate an early dialog after dialog is confirmed.

See Also