LINE_APPNEWCALL メッセージ
TAPI LINE_APPNEWCALL メッセージは、アプリケーションに代わって新しい呼び出しハンドルが自動的に作成されたときに通知するために送信されます (アプリケーションからの API 呼び出しを介した場合を除き、その場合は、関数に渡されたポインター パラメーターを介してハンドルが返されます)。
パラメーター
-
hDevice
-
呼び出しが作成された回線デバイスに対するアプリケーションのハンドル。
-
dwCallbackInstance
-
呼び出しの行を開くときに指定されたコールバック インスタンス。
-
dwParam1
-
呼び出しが表示される行のアドレスの識別子。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード全体で一定のままです。
-
dwParam2
-
新しい呼び出しに対するアプリケーションのハンドル。
-
dwParam3
-
新しい呼び出し (LINECALLPRIVILEGE_OWNERまたはLINECALLPRIVILEGE_MONITOR) に対するアプリケーション特権。
戻り値
戻り値はありません。
解説
TAPI バージョン 2.0 以降をサポートするアプリケーションは、アプリケーションに新しい呼び出しへのハンドルが自発的に渡されるたびに、 LINE_APPNEWCALL メッセージが送信されます。 メッセージには、呼び出しが存在する hLine パラメーターと dwAddressID パラメーターが含まれているため、アプリケーションは正しいコンテキストで新しい呼び出しオブジェクトを簡単に作成できます。 LINE_APPNEWCALL メッセージの直後には、呼び出しの初期状態を示すLINE_CALLSTATE メッセージが常に続きます。
古いアプリケーション (2.0 より前の API バージョンをネゴシエートした) は、以前のバージョンの API に記載されているように、 LINE_CALLSTATE メッセージのみが送信されます。 このようなアプリケーションでは、dwParam3 が 0 以外の値に設定され、アプリケーションで現在認識されていない呼び出しハンドルを含むLINE_CALLSTATE メッセージを受信すると、新しい呼び出しオブジェクトが作成されます。 欠点は、(a) アプリケーションで lineGetCallInfo を呼び出して、呼び出しに関連付けられている hLine パラメーターと dwAddressID パラメーターを決定する必要があることです。(b) アプリケーションは、既知のすべての呼び出しハンドルをスキャンして、呼び出しが新しい呼び出しであることを判断する必要があります。(c) 特定の条件下では、アプリケーションが呼び出しへのハンドルの割り当てを解除した時点で、アプリケーションが新しい呼び出しハンドルを受信していると考える可能性があります (たとえば、アプリケーションは呼び出しハンドルの割り当てを解除したばかりですが、別のアプリケーションからの lineHandoff が原因でアプリケーションに呼び出しの所有権を与えるLINE_CALLSTATE メッセージが既にアプリケーションの TAPI メッセージ キューに入っていました)。
要件
| 要件 | 値 |
|---|---|
| TAPI バージョン |
TAPI 2.0 以降が必要です |
| ヘッダー |
|