VoipCallCoordinator.ReserveCallResourcesAsync Méthode

Définition

Espace de noms:

Windows.ApplicationModel.Calls

Surcharges

ReserveCallResourcesAsync()	Réserve les ressources de processeur et de mémoire nécessaires pour un appel VoIP. Vous devez utiliser cette méthode uniquement dans un modèle d’application à processus unique.
ReserveCallResourcesAsync(String)	Réserve les ressources de processeur et de mémoire nécessaires pour un appel VoIP. Vous devez utiliser cette méthode uniquement dans un modèle d’application à deux processus.

ReserveCallResourcesAsync()

Réserve les ressources de processeur et de mémoire nécessaires pour un appel VoIP. Vous devez utiliser cette méthode uniquement dans un modèle d’application à processus unique.

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)

Retours

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Résultat de l’action de réservation.

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (introduit dans v4.0)
Fonctionnalités de l’application	oneProcessVoIP phoneCallHistory phoneCallHistorySystem voipCall

Exemples

Vous ne devez appeler ReserveCallResourcesAsync qu’une seule fois pour chaque appel. L’appel d’une heure ultérieure pour un nouvel appel alors qu’un autre appel existe déjà entraîne une exception avec un HRESULT de -2147024713 (0x800700b7), comme indiqué dans l’exemple de code.

...
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.");
    }
}
...

Remarques

Utilisez cette méthode lorsque votre application VoIP reçoit une notification d’appel entrant ou avant de créer un appel VoIP sortant.

Chaque appel nécessite des ressources distinctes. Pour gérer plusieurs appels VoIP simultanément, vous devez appeler cette méthode une fois pour chaque appel.

Les ressources sont libérées automatiquement à la fin du dernier appel.

ReserveCallResourcesAsync(String)

Réserve les ressources de processeur et de mémoire nécessaires pour un appel VoIP. Vous devez utiliser cette méthode uniquement dans un modèle d’application à deux processus.

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)

Paramètres

taskEntryPoint

String

Platform::String

winrt::hstring

Nom d’une classe définie par l’application qui effectue le travail d’une tâche en arrière-plan. Pour plus d’informations, consultez TaskEntryPoint.

Retours

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Résultat de l’action de réservation.

Attributs

RemoteAsyncAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

phoneCallHistory phoneCallHistorySystem voipCall

Exemples

Vous ne devez appeler ReserveCallResourcesAsync qu’une seule fois pour chaque appel. L’appel d’une heure ultérieure pour un nouvel appel alors qu’un autre appel existe déjà entraîne une exception avec un HRESULT de -2147024713 (0x800700b7), comme indiqué dans l’exemple de code.

...
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.");
    }
}
...

Remarques

Utilisez cette méthode lorsque votre application VoIP reçoit une notification d’appel entrant ou avant de créer un appel VoIP sortant.

Chaque appel nécessite des ressources distinctes. Pour gérer plusieurs appels VoIP simultanément, vous devez appeler cette méthode une fois pour chaque appel.

Les ressources sont libérées automatiquement à la fin du dernier appel.