VoipCallCoordinator.ReserveCallResourcesAsync Método

Definición

Espacio de nombres:

Windows.ApplicationModel.Calls

Sobrecargas

ReserveCallResourcesAsync()	Reserva los recursos de CPU y memoria necesarios para una llamada voIP. Debe usar este método solo en un modelo de aplicación de proceso único.
ReserveCallResourcesAsync(String)	Reserva los recursos de CPU y memoria necesarios para una llamada voIP. Solo debe usar este método en un modelo de aplicación de dos procesos.

ReserveCallResourcesAsync()

Reserva los recursos de CPU y memoria necesarios para una llamada voIP. Debe usar este método solo en un modelo de aplicación de proceso ú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)

Devoluciones

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Resultado de la acción de reserva.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (se introdujo en la versión v4.0)
Características de aplicaciones	oneProcessVoIP phoneCallHistory phoneCallHistorySystem voipCall

Ejemplos

Debe llamar a ReserveCallResourcesAsync solo una vez para cada llamada. Llamarlo a una llamada posterior para una nueva llamada mientras que otra llamada ya existe da como resultado una excepción con un HRESULT de -2147024713 (0x800700b7), como se muestra en el ejemplo 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.");
    }
}
...

Comentarios

Use este método cuando la aplicación VoIP reciba una notificación de llamada entrante o antes de crear una llamada VoIP saliente.

Cada llamada requiere recursos independientes. Para controlar varias llamadas VoIP simultáneamente, debe invocar este método una vez para cada llamada.

Los recursos se liberan automáticamente cuando se completa la última llamada.

ReserveCallResourcesAsync(String)

Reserva los recursos de CPU y memoria necesarios para una llamada voIP. Solo debe usar este método en un modelo de aplicación de dos procesos.

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

Nombre de una clase definida por la aplicación que realiza el trabajo de una tarea en segundo plano. Para obtener más información, vea TaskEntryPoint.

Devoluciones

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Resultado de la acción de reserva.

Atributos

RemoteAsyncAttribute

Requisitos de Windows

Características de aplicaciones

phoneCallHistory phoneCallHistorySystem voipCall

Ejemplos

Debe llamar a ReserveCallResourcesAsync solo una vez para cada llamada. Llamarlo a una llamada posterior para una nueva llamada mientras que otra llamada ya existe da como resultado una excepción con un HRESULT de -2147024713 (0x800700b7), como se muestra en el ejemplo 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.");
    }
}
...

Comentarios

Use este método cuando la aplicación VoIP reciba una notificación de llamada entrante o antes de crear una llamada VoIP saliente.

Cada llamada requiere recursos independientes. Para controlar varias llamadas VoIP simultáneamente, debe invocar este método una vez para cada llamada.

Los recursos se liberan automáticamente cuando se completa la última llamada.