VoipCallCoordinator.ReserveCallResourcesAsync Metode

Definisi

Ruang nama:

Windows.ApplicationModel.Calls

Overload

ReserveCallResourcesAsync()	Mencadangkan sumber daya CPU dan memori yang diperlukan untuk panggilan VoIP. Anda harus menggunakan metode ini hanya dalam model aplikasi proses tunggal.
ReserveCallResourcesAsync(String)	Mencadangkan sumber daya CPU dan memori yang diperlukan untuk panggilan VoIP. Anda harus menggunakan metode ini hanya dalam model aplikasi dua proses.

ReserveCallResourcesAsync()

Mencadangkan sumber daya CPU dan memori yang diperlukan untuk panggilan VoIP. Anda harus menggunakan metode ini hanya dalam model aplikasi proses tunggal.

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)

Mengembalikan

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Hasil dari tindakan reservasi.

Atribut

OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (diperkenalkan dalam v4.0)
Kemampuan aplikasi	oneProcessVoIP phoneCallHistory phoneCallHistorySystem voipCall

Contoh

Anda harus memanggil ReserveCallResourcesAsync hanya sekali untuk setiap panggilan. Memanggilnya waktu berikutnya untuk panggilan baru sementara panggilan lain sudah ada menghasilkan pengecualian dengan HRESULT dari -2147024713 (0x800700b7), seperti yang ditunjukkan dalam contoh kode.

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

Keterangan

Gunakan metode ini saat aplikasi VoIP Anda menerima pemberitahuan panggilan masuk, atau sebelum membuat panggilan VoIP keluar.

Setiap panggilan memerlukan sumber daya terpisah. Untuk menangani beberapa panggilan VoIP secara bersamaan, Anda harus memanggil metode ini sekali untuk setiap panggilan.

Sumber daya dibebaskan secara otomatis ketika panggilan terakhir selesai.

ReserveCallResourcesAsync(String)

Mencadangkan sumber daya CPU dan memori yang diperlukan untuk panggilan VoIP. Anda harus menggunakan metode ini hanya dalam model aplikasi dua proses.

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

Nama kelas yang ditentukan aplikasi yang melakukan pekerjaan tugas latar belakang. Untuk informasi selengkapnya, lihat TaskEntryPoint.

Mengembalikan

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

Hasil dari tindakan reservasi.

Atribut

RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi

phoneCallHistory phoneCallHistorySystem voipCall

Contoh

Anda harus memanggil ReserveCallResourcesAsync hanya sekali untuk setiap panggilan. Memanggilnya waktu berikutnya untuk panggilan baru sementara panggilan lain sudah ada menghasilkan pengecualian dengan HRESULT dari -2147024713 (0x800700b7), seperti yang ditunjukkan dalam contoh kode.

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

Keterangan

Gunakan metode ini saat aplikasi VoIP Anda menerima pemberitahuan panggilan masuk, atau sebelum membuat panggilan VoIP keluar.

Setiap panggilan memerlukan sumber daya terpisah. Untuk menangani beberapa panggilan VoIP secara bersamaan, Anda harus memanggil metode ini sekali untuk setiap panggilan.

Sumber daya dibebaskan secara otomatis ketika panggilan terakhir selesai.