MediaProvider.BeginSdpRenegotiation Method
Begins SDP renegotiation for a given callDialog.
Namespace: Microsoft.Rtc.Collaboration.ComponentModel
Assembly: Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)
Syntax
'Declaration
Protected Function BeginSdpRenegotiation ( _
callDialog As CallDialogContext, _
userCallback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Usage
Dim callDialog As CallDialogContext
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = Me.BeginSdpRenegotiation(callDialog, _
userCallback, state)
protected IAsyncResult BeginSdpRenegotiation(
CallDialogContext callDialog,
AsyncCallback userCallback,
Object state
)
Parameters
- callDialog
Type: Microsoft.Rtc.Collaboration.CallDialogContext
SignalingContext for the corresponding call dialog.
- userCallback
Type: System.AsyncCallback
The method to be called when the asynchronous operation is completed.
- state
Type: System.Object
A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.
Return Value
Type: System.IAsyncResult
An IAsyncResult that references the asynchronous operation.
Exceptions
| Exception | Condition |
|---|---|
| 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.