TSPI_lineSetStatusMessages関数 (tspi.h)

[アーティクル]
08/26/2023

TSPI_lineSetStatusMessages関数を使用すると、TAPI は、指定された行またはそのアドレスの状態変更に関連するイベントに対してサービスプロバイダーが生成する通知メッセージを指定できます。

構文

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

パラメーター

hdLine

新しいフィルターを設定するラインデバイスへのハンドル。

dwLineStates

メッセージが TAPI に送信される行デバイスの状態が変わるかどうかを識別するビット配列。このパラメーターでは、 LINEDEVSTATE_定数のいずれかを使用します。

dwAddressStates

メッセージが変更されたアドレスの状態を識別するビット配列を TAPI に送信します。このパラメーターでは、 LINEADDRESSSTATE_定数のいずれかを使用します。

戻り値

関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。可能な戻り値は次のとおりです。

LINEERR_INVALADDRESSSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALLINESTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM。

注釈

dwLineStates パラメーターにLINEDEVSTATE_定数ではない 1 つ以上のビットが含まれている場合、サービスプロバイダーはLINEERR_INVALLINESTATEを返します。

テレフォニーは、行とアドレスで発生するイベントについてアプリケーションに通知するメッセージの数を定義します。すべてのアプリケーションが関心を持つすべての変更メッセージのセットは、考えられるメッセージのセットよりもはるかに小さくなります。この手順により、TAPI は、配信するメッセージの削減セットをサービスプロバイダーに通知できます。サービスプロバイダーは、サポートするすべてのメッセージを、指定されたセット内で配信します。より多くの配信が許可されていますが (TAPI によってフィルター処理されます)、パフォーマンス上の理由からこれを行うことをお勧めします。 TAPI がプロバイダーによって生成されない特定のメッセージの種類の配信を要求した場合、プロバイダーは要求を受け入れますが、単にメッセージを生成しません。既定では、住所と行の状態レポートは、最初は行に対して無効になっています。

この関数は、対応する TAPI 関数とは異なります。(1) 要求されるメッセージのセットは、TAPI レベルでアプリケーションによって要求されたすべてのセットの和集合です。 (2) メッセージ・セットは所有権によって縮小も拡張もされません (TSPI レベルでは所有権の概念がないため) (3) このセットは、サービス・プロバイダーが少なくとも指定されたメッセージ・セットを転送する必要があるが、より大きなセットの転送が許可されるという意味でアドバイザリです。

TSPI レベルでは未処理の Open が一度に 1 つしかないため、Open と Close に関するデバイスの状態の変更は報告されません。