ITAutomatedPhoneControl::p ut_AutoKeypadTones メソッド (tapi3if.h)

[アーティクル]
03/05/2024

put_AutoKeypadTonesメソッドは、この電話の AutoKeypadTones プロパティを設定します。この機能を有効にすると、キーパッドボタンが押されるたびにディジットトーンが自動的に再生されます。

構文

HRESULT put_AutoKeypadTones(
  [in] VARIANT_BOOL fEnabled
);

パラメーター

[in] fEnabled

VARIANT_TRUE場合は、自動電話キーパッドのトーン生成が有効になります。 VARIANT_FALSEすると、キーパッドのトーン生成は無効になります。既定値はVARIANT_TRUEです。

戻り値

メソッドが成功した場合は、S_OK を返します。それ以外の場合は、エラー値を返します。

注釈

電話デバイスがボタン押下をPBS_DOWNとして報告した場合、電話デバイスがPBS_UPイベントを報告するまで、または最小期間が経過するまで、どちらか長い方までトーンが再生されます。 (最小期間は 、AutoKeypadTonesMinimumDuration プロパティによって決まります)。

キーパッドトーンの生成は、電話機がオフフックの場合にのみ発生します。リングバックなどの別のトーンが現在再生されている場合、キーパッドトーンはそのトーンを中断し、キーパッドトーンが終了した後に自動的に復元されます。

AutoKeypadTones プロパティは、PhoneHandlingEnabled プロパティの値がVARIANT_TRUEされている場合にのみ機能します。 AutoKeypadTones プロパティはいつでも設定できます。再構成は、次回電話キーパッドボタンを押したときに有効になります。