LINEEVENT

コールバック

シグネチャ

void LINEEVENT(
    HTAPILINE htLine,
    HTAPICALL htCall,
    DWORD dwMsg,
    UINT_PTR dwParam1,
    UINT_PTR dwParam2,
    UINT_PTR dwParam3
);

パラメーター

フィールド	型	説明
htLine	HTAPILINE	イベントが発生した回線の TAPI ハンドル。
htCall	HTAPICALL	通話に関連するイベントの場合は、イベントが発生した通話の TAPI ハンドル。通話が存在しない回線関連のイベントでは、このパラメーターには NULL が設定されます。
dwMsg	DWORD	報告されるイベントの種類を指定します。他のパラメーターの解釈は、dwMsg が示すコンテキストに応じて異なります。
dwParam1	UINT_PTR	メッセージのパラメーター。
dwParam2	UINT_PTR	メッセージのパラメーター。
dwParam3	UINT_PTR	メッセージのパラメーター。

公式ドキュメント

Line_Event は TAPI が実装するコールバック関数で、 TSPI_lineOpen のパラメーターとしてサービスプロバイダーに渡されます。サービスプロバイダーは、回線上または回線上の通話で発生したイベントを報告するために、この関数を呼び出します。

LINEEVENT 型は、このコールバック関数へのポインターを定義します。Line_Event は、アプリケーション定義の関数名を表すプレースホルダーです。

解説(Remarks)

この関数を呼び出すときの通話状態は、どの状態であってもかまいません。

サービスプロバイダーは、 HTAPILINE 値( TSPI_lineOpen に渡されたもの)を htLine パラメーターとして渡します。そこには、メッセージ識別子と、そのイベントに固有のパラメーターが含まれます。

この関数は、回線のパラメーターと通話のパラメーターを分離している点で、TAPI レベルで定義されているコールバック関数とは異なります。一部のメッセージでは、その両方のパラメーターが使用されます。このプロシージャに渡されるメッセージの種類は、TAPI レベルのものとは若干異なります。特に、非同期に実行される要求の完了は、このコールバックではなく Completion_Proc コールバックを通じて報告されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)