LINE_CALLSTATE メッセージ
TAPI LINE_CALLSTATE メッセージは、指定された呼び出しの状態が変更されたときに送信されます。 通常、このようなメッセージは、通話の有効期間中に受信されます。 アプリケーションには、このメッセージを使用して新しい着信呼び出しが通知されます。新しい呼び出しは オファリング 状態です。 アプリケーションでは 、lineGetCallStatus を使用して、呼び出しの現在の状態に関する詳細情報を取得できます。
パラメーター
-
hDevice
-
呼び出しのハンドル。
-
dwCallbackInstance
-
呼び出しの行を開くときに指定されたコールバック インスタンス。
-
dwParam1
-
新しい呼び出し状態。 このパラメーターは、次の LINECALLSTATE_定数のいずれか 1 つだけである必要があります。
dwParam1 説明 - LINECALLSTATE_BUSY
dwParam2 には、ビジー モードに関する詳細が含まれています。 このパラメーターでは、 LINEBUSYMODE_定数のいずれかを使用します。 - LINECALLSTATE_CONNECTED
dwParam2 には、接続モードに関する詳細が含まれています。 このパラメーターでは、 LINECONNECTEDMODE_定数のいずれかを使用します。 - LINECALLSTATE_DIALTONE
dwParam2 には、ダイヤル トーン モードに関する詳細が含まれています。 このパラメーターでは、 LINEDIALTONEMODE_定数のいずれかを使用します。 - LINECALLSTATE_OFFERING
dwParam2 には、接続モードに関する詳細が含まれています。 このパラメーターでは、 LINEOFFERINGMODE_定数のいずれかを使用します。 - LINECALLSTATE_SPECIALINFO
dwParam2 には、特殊な情報モードに関する詳細が含まれています。 このパラメーターでは、 LINESPECIALINFO_定数のいずれかを使用します。 - LINECALLSTATE_DISCONNECTED
dwParam2 には、切断モードに関する詳細が含まれています。 このパラメーターでは、 LINEDISCONNECTMODE_定数のいずれかを使用します。 -
dwParam2
-
呼び出し状態に依存する情報。 dwParam1 を参照してください。
Note
遅延応答が適切な状況では、LINEDISCONNECTMODE_TEMPFAILUREを使用します。 ブロックリスト化された応答が適切な場合は、LINEDISCONNECT_BLOCKEDを使用します。 詳細については、「 定数のLINEDISCONNECTMODE_」を参照してください。
dwParam1 がLINECALLSTATE_CONFERENCEDの場合、dwParam2 には、サブジェクト hCall がメンバーである会議の親呼び出しの hConfCall パラメーターが含まれます。 dwParam2 で指定された呼び出しが、以前にアプリケーションによって親電話会議と見なされなかった場合 (hConfCall、アプリケーションは、このメッセージの結果としてこれを行う必要があります。 アプリケーションに会議の親呼び出しへのハンドルがない場合 (そのハンドルで lineDeallocateCall が以前に呼び出されているため) 、dwParam2 は NULL に設定されます。
-
dwParam3
-
0 の場合、このパラメーターは、呼び出しに対するアプリケーションの特権に変更がないことを示します。
0 以外の場合は、呼び出しに対するアプリケーションの特権を指定します。 これは、(1) アプリケーションにこの呼び出しへのハンドルが初めて与えられた場合に発生します。(2) アプリケーションが呼び出しハンドオフのターゲットである場合 (アプリケーションが既に呼び出しの所有者であった場合でも)。 このパラメーターでは、次の LINECALLPRIVILEGE_定数のいずれかを使用します。
戻り値
戻り値はありません。
解説
このメッセージは、呼び出しのハンドルを持つ任意のアプリケーションに送信されます。 また、LINE_CALLSTATE メッセージは、他のアプリケーションによって確立された発信呼び出しの存在と状態、またはユーザーが手動で (たとえば、接続された電話デバイス上で) 行の呼び出しを監視するアプリケーションに通知します。 このような呼び出しの呼び出し状態には、呼び出しの実際の状態が反映されます。これは、 提供されていません。 呼び出しの状態を調べることで、アプリケーションは、呼び出しが応答する必要がある着信呼び出しであるかどうかを判断できます。
呼び出し状態が不明な LINE_CALLSTATE メッセージは、別のアプリケーションによって要求された lineMakeCall、 lineForward、 lineUnpark、 lineSetupTransfer、 linePickup、 lineSetupConference、または linePrepareAddToConference の結果として監視アプリケーションに送信できます。 要求するアプリケーションが要求された操作の LINE_REPLY (成功) を送信すると同時に、行上のすべての監視アプリケーションには 、LINE_CALLSTATE (不明) メッセージが送信されます。 新しく生成された呼び出しの "実際の" 呼び出し状態を示す LINE_CALLSTATE メッセージは、その直後に要求および監視アプリケーションに (サービス プロバイダーから提供された情報を使用して) 送信されます。
lineCompleteTransfer によって呼び出しが 3 方向会議に解決された場合にのみ、LINE_CALLSTATE (不明) メッセージが監視アプリケーションに送信されます。
下位互換性のために、古いアプリケーションでは、LINECALLSTATE_CONFERENCED メッセージの dwParam2 の特定の値は想定されていません。 したがって TAPI は、メッセージを受信するアプリケーションの API バージョンに関係なく、dwParam2 で親呼び出し hConfCall を渡します。 サービス プロバイダーによって開始された電話会議の場合、古いアプリケーションは、他の情報 (通話 ラインGetConfRelatedCalls など) を自発的に調べない限り、親呼び出しが電話会議になったことを認識しません。
このメッセージを無効にすることはできません。
要件
| 要件 | 値 |
|---|---|
| TAPI バージョン |
TAPI 2.0 以降が必要です |
| ヘッダー |
|