TSPI メッセージ
このセクションには、テレフォニー サービス プロバイダー インターフェイス (TSPI) のメッセージの一覧が含まれています。 これらのメッセージは、サービス プロバイダー内で自発的に発生する非同期イベントの発生を TAPI に通知するために使用されます。 サービス プロバイダーは、サービス プロバイダーが回線、通話、または電話デバイスでイベントを報告しているかどうかに応じて、 LINEEVENT コールバック関数または PHONEEVENT コールバック関数を呼び出すことによって、これらのイベントを TAPI に渡します。 回線または呼び出しで発生したイベントを報告するための LINEEVENT プロシージャは、 TSPI_lineOpen関数を 使用して行を開いた時点でサービス プロバイダーに提供されます。 電話で発生したイベントを報告するための PHONEEVENT プロシージャには、 TSPI_phoneOpen 関数が付属しています。
これらの自発的なイベントは、要求に対する直接の応答ではないという意味で TAPI によって一方的に要求されません。 これらのイベントは、TAPI によって行われた要求の完了を報告するイベントとは対照的です。 このような完了イベントは、 ASYNC_COMPLETION コールバック関数を介して報告されます。
自発イベント プロシージャのパラメーター プロファイルには、イベントが報告される関連オブジェクト (電話、回線、または呼び出し) を識別するパラメーターが含まれます。 識別は、正確な解釈が TSPI によって公開されていない不透明なハンドルの形式です。 TAPI は、これらの不透明なハンドルと、デバイスを表すために使用されたデータ構造との間の関係を内部的に決定します。
自発イベント プロシージャのパラメーター プロファイルには、メッセージの種類を識別するメッセージ パラメーターも含まれています。 各メッセージの種類には、含まれるハンドルとその他のパラメーターとその意味を決定する対応する定義があります。 TSPI レベルで表示されるメッセージと TAPI レベルで表示されるメッセージの間には、非常に強力な対応があります。 通信の一般的なルールは次のとおりです。
- メッセージのセットはほぼ同じです。 メッセージが対応する場合は、TSPI レベルで同じメッセージ名と値が使用されます。
- TSPI レベルで表示されるハンドルは、TSPI 仕様で定義されている不透明な型です。 これらの型 (およびその解釈) は、TAPI レベルの型とは異なりますが、同じクラスのデバイスを参照します。 たとえば、TAPI メッセージに HLINE ハンドルが含まれている場合、対応する TSPI メッセージには通常 、HTAPILINE ハンドルが含まれます。
- コールバックに 渡される dwCallbackInstance データはありません。
- dwParam1、dwParam2、および dwParam3 パラメーターは、通常、TAPI メッセージの対応するパラメーターと同じです。
- 行指向メッセージと呼び出し指向メッセージは、電話指向メッセージとは異なるコールバック プロシージャに渡されます。
このセクションでは、メッセージごとに次の項目を一覧表示します。
- メッセージの目的
- このメッセージが渡されるコールバック プロシージャ
- メッセージ パラメーターの説明
- メッセージの使用に関する省略可能なコメント
- 他の関数、メッセージ、およびデータ構造への省略可能な参照
- このメッセージを TAPI インターフェイスと比較するオプションのコメント
特定のメッセージは、オブジェクトの状態の変更について TAPI に通知するために使用されます。 これらのメッセージは、TAPI の不透明なオブジェクト ハンドルと、どの状態項目が変更されたかを示します。 TAPI は、その後、オブジェクトの適切な "状態の取得" 関数を呼び出して、オブジェクトの完全な状態を取得できます。
イベントが発生すると、メッセージが TAPI に送信される場合と送信されない場合があります。 状態の変更など、一部のイベントの種類では、TAPI は関心のある一連の状態変更を指定します。 サービス プロバイダーは、報告するステータス変更メッセージ イベントを、このセットに含まれるイベントに制限することをお勧めします。 サービス プロバイダーは、この制限に従う必要はありません。 言い換えると、厳密に必要以上の変更が報告される場合があります。 ただし、パフォーマンス上の理由から制限を確認する必要があります。
LINE_REPLY メッセージは TSPI レベルでは使用されません。 非同期要求の完了は、 ASYNC_COMPLETION コールバックを使用して報告されます。
PHONE_REPLY メッセージは TSPI レベルでは使用されません。 非同期要求の完了は、 ASYNC_COMPLETION コールバックを使用して報告されます。
詳細については、以下のトピックを参照してください。