LINEEVENT コールバック関数 (tspi.h)

  • [アーティクル]

Line_Event は TAPI によって実装され、TSPI_lineOpenのパラメーターとしてサービス プロバイダーに提供されるコールバック関数です。 サービス プロバイダーは、この関数を呼び出して、行または行の呼び出しで発生したイベントを報告します。

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

構文

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

パラメーター

htLine

イベントが発生した行の TAPI ハンドル。

htCall

イベントが呼び出し関連のイベントである場合に発生した呼び出しの TAPI ハンドル。 呼び出しがない行関連イベントの場合、このパラメーターは NULL に設定されます。

dwMsg

報告されるイベントの種類を指定します。 他のパラメーターの解釈は、 dwMsg によって示されるコンテキストに応じて異なる方法で実行されます。

dwParam1

メッセージのパラメーター。

dwParam2

メッセージのパラメーター。

dwParam3

メッセージのパラメーター。

戻り値

なし

解説

この関数を呼び出すときの呼び出し状態は、任意の状態にすることができます。

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

この関数は、TAPI レベルで定義されているコールバック関数とは異なり、行パラメーターと呼び出しパラメーターを分離します。 両方のパラメーターが一部のメッセージに使用されます。 この手順に渡すことができるメッセージのセットは、TAPI レベルとは若干異なります。 特に、非同期的に実行される要求の完了は、このコールバックではなく 、Completion_Proc コールバックを介して報告されます。

要件

要件 値
対象プラットフォーム Windows
ヘッダー tspi.h

こちらもご覧ください

Completion_Proc

TSPI_lineOpen