phoneGetRing 関数 (tapi.h)

  • [アーティクル]

phoneGetRing 関数を使用すると、アプリケーションは、現在のリング モードに関して、指定された開いている電話デバイスに対してクエリを実行できます。

構文

LONG phoneGetRing(
  HPHONE  hPhone,
  LPDWORD lpdwRingMode,
  LPDWORD lpdwVolume
);

パラメーター

hPhone

開いている電話デバイスにハンドルします。

lpdwRingMode

電話が呼び出されている呼び出しパターン。 ゼロは、電話が呼び出されていないことを示します。

lpdwVolume

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

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPHONESTATE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_OPERATIONFAILED、PHONEERR_OPERATIONUNAVAIL、PHONEERR_UNINITIALIZED。

注釈

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

要件

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

こちらもご覧ください

補助電話サービス機能

TAPI 2.2 リファレンスの概要