LINE_NEWCALL メッセージ

TSPI LINE_NEWCALL メッセージは、TAPI が発信されていない新しい呼び出しが TAPI が開いている行に到着するたびに、 LINEEVENT コールバック関数に送信されます。 これは、その呼び出しに関して送信される最初のメッセージである必要があります。 TAPI は、サービス プロバイダーによって dwParam2 として渡された場所に htCall 不透明ハンドルを書き込みます。 これにより、サービス プロバイダーに、後続のメッセージで使用される htCall 値が提供されます。

パラメーター

htLine

ライン デバイスへの TAPI 不透明オブジェクト ハンドル。

htCall

未使用。

dwMsg

値LINE_NEWCALL。

dwParam1

HDRVCALL 型の呼び出しに対するサービス プロバイダーの不透明なハンドル。 TAPI は、この値を hdCall パラメーターとして渡して、呼び出しを操作するために呼び出す後続のプロシージャで呼び出しを識別します。

dwParam2

HTAPICALL を指す LPHTAPICALL 型のポインター。 TAPI は、指定された場所への呼び出しに対して TAPI 不透明ハンドルを書き込みます。 サービス プロバイダーは、この値を保存し、 htCall パラメーターとして渡して、呼び出しについて報告する後続のイベントで呼び出しを識別する必要があります。

このパラメーターは NULL の値を取得することもできます (次の「解説」セクションを参照)。

dwParam3

未使用。

解説

サービス プロバイダーは、この呼び出しの次のメッセージとして LINE_CALLSTATE メッセージを送信する必要があります。 LINE_NEWCALL イベントは、値をサービス プロバイダーに返すという点では通常と異なっています。

この関数は、TAPI とサービス プロバイダーがまだ不透明なハンドルを交換していないサービス プロバイダー (着信、送信、電話で開始されるなど) で発信された新しい呼び出しを報告します。 TAPI とサービス プロバイダーが呼び出しに関連する要求とレポート イベントを実行できるように、ハンドルが交換されます。 これらの新しい呼び出しは必ずしも受信されるとは限らないので、呼び出しは最初は任意の状態になる可能性があり、必ずしも オファリング 状態であるとは限りません。 サービス プロバイダーが開始し、1 つ以上の呼び出しが行で既にアクティブであることを検出した場合は、LINE_NEWCALL メッセージの後に現在の状態 を 示す メッセージLINE_CALLSTATE TAPI に通知します。 ユーザーが電話で開始した新しい発信呼び出しは、 LINE_NEWCALL メッセージで報告され、最初 のLINE_CALLSTATE メッセージは、通話が DIALTONE 状態であることを示します (その後、そこから続行されます)。

サービス プロバイダーが非常に短い時間 (同じ割り込みサイクル中) に多数の呼び出しを TAPI に渡すと、TAPI がそれらの呼び出しの処理でバックログに入る可能性があります。 これが発生すると、TAPI はサービス プロバイダーに対して、それ以上の呼び出しを送信する前に短時間待機するように通知します。 有効な HTAPICALL の代わりに NULL 値を、LINE_NEWCALL の dwParam2 パラメーターが指す場所に書き込むことで、これを通知します。 これは、新しく提供された呼び出しハンドルの処理が成功しなかったことを示します。これは、メモリを一時的に割り当てられなかったことが原因である可能性が最も高いです。 サービス プロバイダーは、呼び出しを削除するか、スケジュールの遅延の後 にLINE_NEWCALL メッセージを再送信することによって応答できます (その間、サービス プロバイダーは、TAPI が他の保留中のアクションを処理できるようにプロセッサを生成する必要があります)。 いずれの場合も、ハンドル交換が成功するまで、新しい呼び出しに関するそれ以上のメッセージを TAPI に渡すことができません。 dwParam2 が指す場所が NULL 以外の値を取得すると、サービス プロバイダーは、この値が呼び出しに対する有効な HTAPICALL ハンドルであることを認識します。

TAPI レベルに直接対応するメッセージはありません。 このメッセージは、TSPI レベルで使用され、TAPI への新しい着信呼び出しを一意かつ明確に導入し、呼び出しの TAPI 不透明識別子を取得します。

要件

要件	値
TAPI バージョン	TAPI 2.0 以降が必要です
Header	Tspi.h

こちらもご覧ください

LINE_CALLSTATE

LINEEVENT