lineGetNumRings 関数 (tapi.h)

[アーティクル]
08/26/2023

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 でもこの番号が使用されます。

メモこの操作は純粋に情報であり、それ自体が回線デバイス上の呼び出しの状態に影響を与えることはありません。