Share via

TSPI_lineSelectExtVersion関数 (tspi.h)

  • [アーティクル]

TSPI_lineSelectExtVersion関数は、指定された回線デバイスの指定された拡張バージョンを選択します。 後続の要求は、その拡張機能のバージョンに従って動作します。

構文

LONG TSPIAPI TSPI_lineSelectExtVersion(
  HDRVLINE hdLine,
  DWORD    dwExtVersion
);

パラメーター

hdLine

拡張機能のバージョンを選択する行へのハンドル。

dwExtVersion

選択する拡張機能のバージョン。 このバージョン番号は、 TSPI_lineNegotiateExtVersionを使用してネゴシエートされています。 最も重要な WORD はメジャー バージョン番号で、最も重要でない WORD はマイナー バージョン番号です。 dwExtVersion を 0 に設定してこの関数を呼び出すと、現在の選択範囲が取り消されます。

戻り値

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

LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。

注釈

サービス プロバイダーは、指定された拡張機能のバージョンを選択します。 指定されたバージョン番号は正常にネゴシエートされた可能性がありますが、その間に別の拡張機能バージョンが選択されている可能性があります。この場合、この関数は失敗します (LINEERR_INCOMPATIBLEEXTVERSIONを返します)。

拡張機能のバージョンが選択された後の行に対する後続の操作は、その拡張機能のバージョンに従って動作します。 拡張機能のバージョンレポートをネゴシエートする後続の試行では、厳密に選択されたバージョンまたは 0 (要求された範囲に選択したバージョンが含まれていない場合) が報告されます。 特殊な拡張機能バージョン 0 でこのプロシージャを呼び出すと、現在の選択が取り消されます。 デバイスは、拡張バージョン番号の全範囲をサポートできるようになります。

この関数は TAPI レベルでは直接対応しません。ここで、拡張機能バージョンの選択は lineOpen の他の機能とバンドルされています。 TSPI_lineSelectExtVersion関数は、通常、2 つの状況で呼び出されます。(1) 行を開くよう要求されたアプリケーション、メディアの種類の監視の結果の変更が成功した、アプリケーションが特定の拡張機能バージョンの使用を要求し、拡張機能のバージョンが現在選択されていません。 (2) 特定の拡張機能バージョンを使用した最後のアプリケーションが行を閉じ、拡張機能のバージョンの選択を取り消すことができます。

要件

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

こちらもご覧ください

TSPI_lineNegotiateExtVersion