VoipCallCoordinator.ReserveCallResourcesAsync Método

Definição

Namespace:

Windows.ApplicationModel.Calls

Sobrecargas

ReserveCallResourcesAsync()	Reserva os recursos de CPU e memória necessários para uma chamada VoIP. Você deve usar esse método apenas em um modelo de aplicativo de processo único.
ReserveCallResourcesAsync(String)	Reserva os recursos de CPU e memória necessários para uma chamada VoIP. Você deve usar esse método apenas em um modelo de aplicativo de dois processos.

ReserveCallResourcesAsync()

Reserva os recursos de CPU e memória necessários para uma chamada VoIP. Você deve usar esse método apenas em um modelo de aplicativo de processo único.

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)

Retornos

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

O resultado da ação de reserva.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (introduzida na v4.0)
Funcionalidades do aplicativo	oneProcessVoIP phoneCallHistory phoneCallHistorySystem voipCall

Exemplos

Você deve chamar ReserveCallResourcesAsync apenas uma vez para cada chamada. Chamá-la de uma hora subsequente para uma nova chamada enquanto outra chamada já existe resulta em uma exceção com um HRESULT de -2147024713 (0x800700b7), conforme mostrado no exemplo de código.

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

Comentários

Use esse método quando o aplicativo VoIP receber uma notificação de chamada de entrada ou antes de criar uma chamada VoIP de saída.

Cada chamada requer recursos separados. Para lidar com várias chamadas VoIP simultaneamente, você deve invocar esse método uma vez para cada chamada.

Os recursos são liberados automaticamente quando a última chamada é concluída.

ReserveCallResourcesAsync(String)

Reserva os recursos de CPU e memória necessários para uma chamada VoIP. Você deve usar esse método apenas em um modelo de aplicativo de dois processos.

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)

Parâmetros

taskEntryPoint

String

Platform::String

winrt::hstring

O nome de uma classe definida pelo aplicativo que executa o trabalho de uma tarefa em segundo plano. Para obter mais informações, consulte TaskEntryPoint.

Retornos

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

O resultado da ação de reserva.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo

phoneCallHistory phoneCallHistorySystem voipCall

Exemplos

Você deve chamar ReserveCallResourcesAsync apenas uma vez para cada chamada. Chamá-la de uma hora subsequente para uma nova chamada enquanto outra chamada já existe resulta em uma exceção com um HRESULT de -2147024713 (0x800700b7), conforme mostrado no exemplo de código.

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

Comentários

Use esse método quando o aplicativo VoIP receber uma notificação de chamada de entrada ou antes de criar uma chamada VoIP de saída.

Cada chamada requer recursos separados. Para lidar com várias chamadas VoIP simultaneamente, você deve invocar esse método uma vez para cada chamada.

Os recursos são liberados automaticamente quando a última chamada é concluída.