TSPI_phoneNegotiateTSPIVersion関数 (tspi.h)

  • [アーティクル]

TSPI_phoneNegotiateTSPIVersion関数は、可能な SPI バージョンの範囲に応じて、サービス プロバイダーがこのデバイスで動作できる最高の SPI バージョンを返します。

構文

LONG TSPIAPI TSPI_phoneNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

パラメーター

dwDeviceID

インターフェイス バージョン ネゴシエーションを実行する電話デバイス。 許可される値は、このサービス プロバイダーの電話デバイス識別子の範囲内に厳密に含まれます。 INITIALIZE_NEGOTIATION 値がこの関数に渡されることはありません。

dwLowVersion

TAPI が動作できる最も低い TSPI バージョン番号。 最も重要な WORD はメジャー バージョン番号で、最も重要な WORD はマイナー バージョン番号です。

dwHighVersion

TAPI が動作できる最も大きい TSPI バージョン番号。 最も重要な WORD はメジャー バージョン番号で、最も重要な WORD はマイナー バージョン番号です。

lpdwTSPIVersion

DWORD へのポインター。 この関数から正常に戻ると、サービス プロバイダーは、サービス プロバイダーが操作できる呼び出し元から要求された範囲内で、この場所に最も高い TSPI バージョン番号を入力します。 最も重要な WORD はメジャー バージョン番号で、最下位 の WORD はマイナー バージョン番号です。 要求された範囲がサービス プロバイダーでサポートされている範囲と重複しない場合、関数は PHONEERR_INCOMPATIBLEAPIVERSIONを返します。

戻り値

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

PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL。

解説

操作が使用できない場合、サービス プロバイダーはPHONEERR_OPERATIONUNAVAILを返します。 ただし、サービス プロバイダーが電話デバイスをサポートしている場合は、この関数もサポートする必要があり、関数はPHONEERR_OPERATIONUNAVAILを返す必要はありません。

TAPI は、各電話デバイスの初期化シーケンスの早い段階でこの関数を呼び出します。

拡張機能バージョンのネゴシエーションは、別の手順 TSPI_phoneNegotiateExtVersionを使用して行われます。

TAPI レベルの対応する関数は、サービス プロバイダーによってサポートされている拡張識別子 (存在する場合) も取得するオーバーロードされた関数です。 TSPI レベルでは、拡張機能識別子の取得は、別の手順 ( つまり、TSPI_phoneGetExtensionID) を使用して実行されます。

要件

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

関連項目

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion