phoneSetRing 関数 (tapi.h)

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

phoneSetRing 関数は、指定したリングモードとボリュームを使用して、指定された開いている電話デバイスを呼び出します。

構文

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

パラメーター

hPhone

開いている電話デバイスにハンドルします。アプリケーションは、電話デバイスの所有者である必要があります。

dwRingMode

電話を呼び出す呼び出しパターン。このパラメーターは、PHONECAPS 構造体の dwNumRingModes メンバーの値から 0 の範囲内である必要があります。 dwNumRingModes が 0 の場合、電話機のリングモードを制御することはできません。dwNumRingModes が 1 の場合、dwRingMode の値が 0 の場合は、電話を実行しない (無音) ことを示し、1 から dwNumRingModes までのその他の値は電話デバイスの有効なリングモードです。

dwVolume

電話が鳴る音量レベル。これは、0x0000FFFF (最大ボリューム) に0x00000000 (無音) の範囲内の数値です。この範囲のボリューム設定の実際の粒度と量子化は、サービスプロバイダー固有です。 範囲外の dwVolume の値は、範囲内で最も近い値に設定されます。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。対応するPHONE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_NOTOWNER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALRINGMODE、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。