PHONEEVENT

コールバック

シグネチャ

void PHONEEVENT(
    HTAPIPHONE htPhone,
    DWORD dwMsg,
    UINT_PTR dwParam1,
    UINT_PTR dwParam2,
    UINT_PTR dwParam3
);

パラメーター

フィールド	型	説明
htPhone	HTAPIPHONE	イベントが発生した電話機の TAPI ハンドルです。
dwMsg	DWORD	報告されるイベントの種類を指定します。他のパラメーターの解釈は、dwMsg が示すコンテキストに応じて異なります。
dwParam1	UINT_PTR	メッセージのパラメーターです。
dwParam2	UINT_PTR	メッセージのパラメーターです。
dwParam3	UINT_PTR	メッセージのパラメーターです。

公式ドキュメント

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

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

解説(Remarks)

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

サービスプロバイダーは、 TSPI_phoneOpen に渡された HTAPIPHONE の値を htPhone パラメーターとして渡します。通知には、メッセージ識別子とイベント固有のパラメーターが含まれます。

このプロシージャに渡されるメッセージの集合は、TAPI レベルの対応するコールバックに渡されるメッセージとはわずかに異なります。特に、非同期に実行される要求の完了は、このコールバックではなく Completion_Proc コールバックを通じて報告されます。

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