次の方法で共有


phoneSetRing 関数 (tapi.h)

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。

注釈

サービス プロバイダーは、電話の各リング モードに対応する実際の可聴呼び出しパターンを定義します。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

PHONECAPS

PHONE_REPLY

補助電話サービス機能

TAPI 2.2 リファレンスの概要