lineSetNumRings 関数 (tapi.h)

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

lineSetNumRings 関数は、着信呼び出しに応答する前に発生する必要があるリングの数を設定します。この関数は、有料セーバースタイルの関数を実装するために使用できます。これにより、複数の独立したアプリケーションが各リングの数を登録できます。関数行GetNumRings は、要求されたリングの最小数を返します。これは、着信呼び出しに応答するアプリケーションによって使用され、呼び出しに応答する前に待機する必要があるリングの数を決定できます。

構文

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

パラメーター

hLine

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

dwAddressID

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

dwNumRings

すべてのアプリケーションからの料金節約要求を受け入れるために、通話前のリングの数に応答する必要があります。

戻り値

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

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

注釈

lineGetNumRings 関数と lineSetNumRings 関数を組み合わせて使用すると、複数の独立したアプリケーションに対する有料セーバー機能の実装をサポートするメカニズムが提供されます。 lineSetNumRings を呼び出すアプリケーションがない場合、lineGetNumRings は0xFFFFFFFFを返します。

オファリング状態の通話の所有者であり、LINE_LINEDEVSTATE呼び出しメッセージを受信したアプリケーションは、すべてのアプリケーションで通話に応答する前に、lineGetNumRings によって返された数と同じ数のリングを待機する必要があります。リングサイクルごとに個別のLINE_LINEDEVSTATE 呼び出し メッセージがアプリケーションに送信されるため、アプリケーションはこれらのメッセージをカウントする必要があります。この呼び出しが応答する前に切断され、その直後に別の呼び出しが発生した場合、 LINE_CALLSTATE メッセージは、アプリケーションが呼び出しが 2 番目の呼び出しに関連していることを判断できるようにする必要があります。

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

メモこの操作は純粋に情報であり、回線デバイス上の呼び出しの状態には影響しません。