次の方法で共有

lineGetNumRings 関数 (tapi.h)

  • [アーティクル]

lineGetNumRings 関数は、呼び出しに応答する前に、指定されたアドレスで着信呼び出しが呼び出されるリングの数を決定します。

構文

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

パラメーター

hLine

開線デバイスへのハンドル。

dwAddressID

回線デバイスのアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード間で一定のままです。

lpdwNumRings

現在のすべての lineSetNumRings 要求の最小値であるリングの数。

戻り値

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

LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

備考

lineGetNumRings と lineSetNumRings 関数を組み合わせて使用すると、複数の独立したアプリケーション間での有料サービス機能の実装をサポートするメカニズムが提供されます。

オファリング 状態で呼び出しのハンドルを受け取り、LINE_LINEDEVSTATE呼び出し メッセージを呼び出すアプリケーションは、すべてのアプリケーションで料金を節約する設定を受け入れるには、lineGetNumRings によって返された数と同じ数のリングを待機してから、通話に応答する必要があります。 lineGetNumRings 関数は、lineSetNumRingsで指定されたすべてのアプリケーションのリング数 最小値を返します。 この数は動的に変化する可能性があるため、アプリケーションは、呼び出しに応答するオプションがあるたびに、lineGetNumRings を呼び出す必要があります。 lineSetNumRings呼び出したアプリケーションがない場合、返されるリングの数は0xFFFFFFFF。 メッセージを呼び出すLINE_LINEDEVSTATE は、リング サイクルごとにアプリケーションに送信されます。

呼び出しの分類が、不明なメディア モードのすべての呼び出しに応答し、メディア ストリームをフィルター処理する TAPI によって実行される場合、TAPI はこの番号も受け入れられます。

注 この操作は情報に基づくものであり、それ自体は回線デバイス上の呼び出しの状態には影響しません。
 

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー tapi.h
ライブラリ Tapi32.lib
DLL Tapi32.dll

関連項目

基本的なテレフォニー サービス リファレンス

LINE_LINEDEVSTATE

TAPI 2.2 リファレンスの概要

lineSetNumRings を する