ITAutomatedPhoneControl::get_AutoKeypadTones メソッド (tapi3if.h)

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

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

構文

HRESULT get_AutoKeypadTones(
  [out] VARIANT_BOOL *pfEnabled
);

パラメーター

[out] pfEnabled

この電話機に対して自動電話キーパッドフィードバックトーン生成が有効になっている場合にVARIANT_TRUEします。この電話機に対して自動電話キーパッドフィードバックトーン生成が無効になっている場合にVARIANT_FALSEします。

戻り値

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

注釈

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

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

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