VoipCallCoordinator.ReserveCallResourcesAsync 메서드

정의

네임스페이스:

Windows.ApplicationModel.Calls

오버로드

ReserveCallResourcesAsync()	VoIP 호출에 필요한 CPU 및 메모리 리소스를 예약합니다. 이 메서드는 단일 프로세스 애플리케이션 모델에서만 사용해야 합니다.
ReserveCallResourcesAsync(String)	VoIP 호출에 필요한 CPU 및 메모리 리소스를 예약합니다. 이 메서드는 2개 프로세스 애플리케이션 모델에서만 사용해야 합니다.

ReserveCallResourcesAsync()

VoIP 호출에 필요한 CPU 및 메모리 리소스를 예약합니다. 이 메서드는 단일 프로세스 애플리케이션 모델에서만 사용해야 합니다.

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)

반환

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

예약 작업의 결과입니다.

특성

OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1809 (10.0.17763.0에서 도입되었습니다.)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (v4.0에서 도입되었습니다.)
앱 기능	oneProcessVoIP phoneCallHistory phoneCallHistorySystem voipCall

예제

각 호출에 대해 ReserveCallResourcesAsync 를 한 번만 호출해야 합니다. 다른 호출이 이미 있는 동안 새 호출에 대한 후속 시간을 호출하면 코드 예제와 같이 HRESULT가 -2147024713(0x800700b7)인 예외가 발생합니다.

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

설명

VoIP 애플리케이션이 들어오는 통화 알림을 받거나 나가는 VoIP 호출을 만들기 전에 이 메서드를 사용합니다.

각 호출에는 별도의 리소스가 필요합니다. 여러 VoIP 호출을 동시에 처리하려면 각 호출에 대해 이 메서드를 한 번 호출해야 합니다.

마지막 호출이 완료되면 리소스가 자동으로 해제됩니다.

ReserveCallResourcesAsync(String)

VoIP 호출에 필요한 CPU 및 메모리 리소스를 예약합니다. 이 메서드는 2개 프로세스 애플리케이션 모델에서만 사용해야 합니다.

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)

매개 변수

taskEntryPoint

String

Platform::String

winrt::hstring

백그라운드 작업의 작업을 수행하는 애플리케이션 정의 클래스의 이름입니다. 자세한 내용은 TaskEntryPoint를 참조하세요.

반환

IAsyncOperation<VoipPhoneCallResourceReservationStatus>

예약 작업의 결과입니다.

특성

RemoteAsyncAttribute

Windows 요구 사항

앱 기능	phoneCallHistory phoneCallHistorySystem voipCall

예제

각 호출에 대해 ReserveCallResourcesAsync 를 한 번만 호출해야 합니다. 다른 호출이 이미 있는 동안 새 호출에 대한 후속 시간을 호출하면 코드 예제와 같이 HRESULT가 -2147024713(0x800700b7)인 예외가 발생합니다.

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

설명

VoIP 애플리케이션이 들어오는 통화 알림을 받거나 나가는 VoIP 호출을 만들기 전에 이 메서드를 사용합니다.

각 호출에는 별도의 리소스가 필요합니다. 여러 VoIP 호출을 동시에 처리하려면 각 호출에 대해 이 메서드를 한 번 호출해야 합니다.

마지막 호출이 완료되면 리소스가 자동으로 해제됩니다.