VoipCallCoordinator.ReserveCallResourcesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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)戻り値
予約アクションの結果。
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10, version 1809 (10.0.17763.0 で導入)
|
| API contract |
Windows.ApplicationModel.Calls.CallsVoipContract (v4.0 で導入)
|
| アプリの機能 |
oneProcessVoIP
phoneCallHistory
phoneCallHistorySystem
voipCall
|
例
ReserveCallResourcesAsync は、呼び出しごとに 1 回だけ呼び出す必要があります。 別の呼び出しが既に存在する間に新しい呼び出しの後で呼び出すと、コード例に示すように、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 呼び出しを同時に処理するには、呼び出しごとにこのメソッドを 1 回呼び出す必要があります。
リソースは、最後の呼び出しが完了すると自動的に解放されます。
適用対象
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」を参照してください。
戻り値
予約アクションの結果。
- 属性
Windows の要件
| アプリの機能 |
phoneCallHistory
phoneCallHistorySystem
voipCall
|
例
ReserveCallResourcesAsync は、呼び出しごとに 1 回だけ呼び出す必要があります。 別の呼び出しが既に存在する間に新しい呼び出しの後で呼び出すと、コード例に示すように、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 呼び出しを同時に処理するには、呼び出しごとにこのメソッドを 1 回呼び出す必要があります。
リソースは、最後の呼び出しが完了すると自動的に解放されます。