Share via


VoipPhoneCall.NotifyCallActive Method

Definition

Overloads

NotifyCallActive(IIterable<String>)

Notifies the system that the VoIP call is active; includes associated call control devices.

NotifyCallActive()

Notifies the system that the VoIP call is active.

NotifyCallActive(IIterable<String>)

Notifies the system that the VoIP call is active; includes associated call control devices.

public:
 virtual void NotifyCallActive(IIterable<Platform::String ^> ^ associatedDeviceIds) = NotifyCallActive;
/// [Windows.Foundation.Metadata.Experimental]
/// [Windows.Foundation.Metadata.Overload("NotifyCallActiveOnDevices")]
void NotifyCallActive(IIterable<winrt::hstring> const& associatedDeviceIds);
[Windows.Foundation.Metadata.Experimental]
[Windows.Foundation.Metadata.Overload("NotifyCallActiveOnDevices")]
public void NotifyCallActive(IEnumerable<string> associatedDeviceIds);
function notifyCallActive(associatedDeviceIds)
Public Sub NotifyCallActive (associatedDeviceIds As IEnumerable(Of String))

Parameters

associatedDeviceIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

A list of device interface ids of call control devices to associate with the call. May not be null (otherwise returns E_INVALIDARG). Replaces any existing list of associated devices.

Attributes

Windows requirements

Device family
Windows 11, version 24H2 (introduced in 10.0.26100.0)
API contract
Windows.ApplicationModel.Calls.CallsVoipContract (introduced in v5.0)
App capabilities
phoneCallHistory phoneCallHistorySystem voipCall voipCall

Remarks

The system raises the AnswerRequested event to signal to your VoIP application that the call has been accepted by the system. After the event is raised, your VoIP application must call NotifyCallActive within 5 seconds. See VoipPhoneCall for more info.

When calling this method, your app might wish to specify either a single device (such as the one that accepted the call, or the device that's the active audio endpoint) or a set of devices (such as the device that accepted the call plus a dedicated Bluetooth remote control for calls). Your app may also pass an empty device list. When calling this overload, the VoipPhoneCall.IsUsingAssociatedDevicesList property of the call will be set to true (if not already), and only the associated devices will be able to interact with the call going forward.

Applies to

NotifyCallActive()

Notifies the system that the VoIP call is active.

public:
 virtual void NotifyCallActive() = NotifyCallActive;
void NotifyCallActive();
public void NotifyCallActive();
function notifyCallActive()
Public Sub NotifyCallActive ()

Windows requirements

App capabilities
phoneCallHistory phoneCallHistorySystem voipCall voipCall

Remarks

The system raises the AnswerRequested event to signal to your VoIP application that the call has been accepted by the system. After the event is raised, your VoIP application must call NotifyCallActive within 5 seconds. See VoipPhoneCall for more info.

Applies to