VoipCallCoordinator.ReserveCallResourcesAsync Metodo

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Calls

Overload

ReserveCallResourcesAsync()	Riserva le risorse di CPU e memoria necessarie per una chiamata VoIP. È consigliabile usare questo metodo solo in un modello di applicazione a processo singolo.
ReserveCallResourcesAsync(String)	Riserva le risorse di CPU e memoria necessarie per una chiamata VoIP. È consigliabile usare questo metodo solo in un modello di applicazione a due processi.

ReserveCallResourcesAsync()

Riserva le risorse di CPU e memoria necessarie per una chiamata VoIP. È consigliabile usare questo metodo solo in un modello di applicazione a processo singolo.

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)

Restituisce

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Risultato dell'azione di prenotazione.

Attributi

OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (è stato introdotto in v4.0)
Funzionalità dell'app	oneProcessVoIP phoneCallHistory phoneCallHistorySystem voipCall

Esempio

Devi chiamare ReserveCallResourcesAsync una sola volta per ogni chiamata. Chiamandola una volta successiva per una nuova chiamata mentre esiste già un'altra chiamata, viene generata un'eccezione con hresult di -2147024713 (0x800700b7), come illustrato nell'esempio di codice.

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

Commenti

Usare questo metodo quando l'applicazione VoIP riceve una notifica di chiamata in ingresso o prima di creare una chiamata VoIP in uscita.

Ogni chiamata richiede risorse separate. Per gestire più chiamate VoIP contemporaneamente, è necessario richiamare questo metodo una volta per ogni chiamata.

Le risorse vengono liberate automaticamente al termine dell'ultima chiamata.

ReserveCallResourcesAsync(String)

Riserva le risorse di CPU e memoria necessarie per una chiamata VoIP. È consigliabile usare questo metodo solo in un modello di applicazione a due processi.

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)

Parametri

taskEntryPoint

String

Platform::String

winrt::hstring

Nome di una classe definita dall'applicazione che esegue il lavoro di un'attività in background. Per altre informazioni, vedere TaskEntryPoint.

Restituisce

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Risultato dell'azione di prenotazione.

Attributi

RemoteAsyncAttribute

Requisiti Windows

Funzionalità dell'app

phoneCallHistory phoneCallHistorySystem voipCall

Esempio

Devi chiamare ReserveCallResourcesAsync una sola volta per ogni chiamata. Chiamandola una volta successiva per una nuova chiamata mentre esiste già un'altra chiamata, viene generata un'eccezione con hresult di -2147024713 (0x800700b7), come illustrato nell'esempio di codice.

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

Commenti

Usare questo metodo quando l'applicazione VoIP riceve una notifica di chiamata in ingresso o prima di creare una chiamata VoIP in uscita.

Ogni chiamata richiede risorse separate. Per gestire più chiamate VoIP contemporaneamente, è necessario richiamare questo metodo una volta per ogni chiamata.

Le risorse vengono liberate automaticamente al termine dell'ultima chiamata.