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 |