VoipCallCoordinator.ReserveCallResourcesAsync Methode

Definition

Namespace:

Windows.ApplicationModel.Calls

Überlädt

ReserveCallResourcesAsync()	Reserviert die CPU- und Arbeitsspeicherressourcen, die für einen VoIP-Anruf erforderlich sind. Sie sollten diese Methode nur in einem Einzelprozessanwendungsmodell verwenden.
ReserveCallResourcesAsync(String)	Reserviert die CPU- und Arbeitsspeicherressourcen, die für einen VoIP-Anruf erforderlich sind. Sie sollten diese Methode nur in einem Zwei-Prozess-Anwendungsmodell verwenden.

ReserveCallResourcesAsync()

Reserviert die CPU- und Arbeitsspeicherressourcen, die für einen VoIP-Anruf erforderlich sind. Sie sollten diese Methode nur in einem Einzelprozessanwendungsmodell verwenden.

public:
 virtual IAsyncOperation<VoipPhoneCallResourceReservationStatus> ^ ReserveCallResourcesAsync() = ReserveCallResourcesAsync;

/// [Windows.Foundation.Metadata.Overload("ReserveOneProcessCallResourcesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VoipPhoneCallResourceReservationStatus> ReserveCallResourcesAsync();

[Windows.Foundation.Metadata.Overload("ReserveOneProcessCallResourcesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VoipPhoneCallResourceReservationStatus> ReserveCallResourcesAsync();

function reserveCallResourcesAsync()

Public Function ReserveCallResourcesAsync () As IAsyncOperation(Of VoipPhoneCallResourceReservationStatus)

Gibt zurück

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Das Ergebnis der Reservierungsaktion.

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (eingeführt in v4.0)
App-Funktionen	oneProcessVoIP phoneCallHistory phoneCallHistorySystem voipCall

Beispiele

Sie sollten ReserveCallResourcesAsync nur einmal für jeden Aufruf aufrufen. Wenn sie einen späteren Zeitpunkt für einen neuen Aufruf aufruft, während bereits ein anderer Aufruf vorhanden ist, wird eine Ausnahme mit einem HRESULT von -2147024713 (0x800700b7) ausgelöst, wie im Codebeispiel gezeigt.

...
try
{
    status = await vCC.ReserveCallResourcesAsync();
}
catch (System.Exception ex)
{
    if (ex.HResult == -2147024713)
    {
        Debug.WriteLine("CPU and memory resources have already been reserved for your application. Ignore the return value from your call to ReserveCallResourcesAsync, and proceed to handle a new VoIP call.");
    }
}
...

Hinweise

Verwenden Sie diese Methode, wenn Ihre VoIP-Anwendung eine Benachrichtigung über eingehende Anrufe empfängt oder bevor Sie einen ausgehenden VoIP-Anruf erstellen.

Jeder Aufruf erfordert separate Ressourcen. Um mehrere VoIP-Aufrufe gleichzeitig zu verarbeiten, müssen Sie diese Methode einmal für jeden Aufruf aufrufen.

Ressourcen werden automatisch freigegeben, wenn der letzte Aufruf abgeschlossen ist.

ReserveCallResourcesAsync(String)

Reserviert die CPU- und Arbeitsspeicherressourcen, die für einen VoIP-Anruf erforderlich sind. Sie sollten diese Methode nur in einem Zwei-Prozess-Anwendungsmodell verwenden.

public:
 virtual IAsyncOperation<VoipPhoneCallResourceReservationStatus> ^ ReserveCallResourcesAsync(Platform::String ^ taskEntryPoint) = ReserveCallResourcesAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<VoipPhoneCallResourceReservationStatus> ReserveCallResourcesAsync(winrt::hstring const& taskEntryPoint);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<VoipPhoneCallResourceReservationStatus> ReserveCallResourcesAsync(string taskEntryPoint);

function reserveCallResourcesAsync(taskEntryPoint)

Public Function ReserveCallResourcesAsync (taskEntryPoint As String) As IAsyncOperation(Of VoipPhoneCallResourceReservationStatus)

Parameter

taskEntryPoint

String

Platform::String

winrt::hstring

Der Name einer anwendungsdefinierten Klasse, die die Arbeit einer Hintergrundaufgabe ausführt. Weitere Informationen finden Sie unter TaskEntryPoint.

Gibt zurück

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Das Ergebnis der Reservierungsaktion.

Attribute

RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen

phoneCallHistory phoneCallHistorySystem voipCall

Beispiele

Sie sollten ReserveCallResourcesAsync nur einmal für jeden Aufruf aufrufen. Wenn sie einen späteren Zeitpunkt für einen neuen Aufruf aufruft, während bereits ein anderer Aufruf vorhanden ist, wird eine Ausnahme mit einem HRESULT von -2147024713 (0x800700b7) ausgelöst, wie im Codebeispiel gezeigt.

...
try
{
    status = await vCC.ReserveCallResourcesAsync(Current.RtcCallTaskName);
}
catch (System.Exception ex)
{
    if (ex.HResult == -2147024713)
    {
        Debug.WriteLine("CPU and memory resources have already been reserved for your application. Ignore the return value from your call to ReserveCallResourcesAsync, and proceed to handle a new VoIP call.");
    }
}
...

Hinweise

Verwenden Sie diese Methode, wenn Ihre VoIP-Anwendung eine Benachrichtigung über eingehende Anrufe empfängt oder bevor Sie einen ausgehenden VoIP-Anruf erstellen.

Jeder Aufruf erfordert separate Ressourcen. Um mehrere VoIP-Aufrufe gleichzeitig zu verarbeiten, müssen Sie diese Methode einmal für jeden Aufruf aufrufen.

Ressourcen werden automatisch freigegeben, wenn der letzte Aufruf abgeschlossen ist.