TSPI_lineOpen関数 (tspi.h)

[アーティクル]
03/09/2024

TSPI_lineOpen関数は、デバイス識別子が指定された回線デバイスを開き、デバイスのサービスプロバイダーのハンドルを返します。サービスプロバイダーは、 LINEEVENT コールバックプロシージャの後続の呼び出しで使用するために、デバイスの TAPI ハンドルを保持する必要があります。

構文

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

パラメーター

dwDeviceID

開く回線デバイスを識別します。

htLine

LINEEVENT コールバックプロシージャの後続の呼び出しでデバイスを識別するために使用される回線デバイスの TAPI ハンドル。

lphdLine

サービスプロバイダーが回線デバイスのハンドルを入力する HDRVLINE へのポインター。

dwTSPIVersion

TSPI バージョン。

lpfnEventProc

サービスプロバイダーが行の後続のイベントを報告するために呼び出す TAPI によって提供される LINEEVENT コールバックプロシージャへのポインター。

戻り値

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

LINEERR_ALLOCATED、LINEERR_OPERATIONUNAVAIL、LINEERR_NODRIVER、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注釈

サービスプロバイダーは、回線の管理に必要な共有不可能なリソースを予約する必要があります。ただし、 lineMakeCall に延期できるアクションはすべてである必要があります。これは、lineOpen が "安価な" 操作であるという TAPI の設計上の前提です。たとえば、行がモニターモードでのみ開かれている場合、COMM ポートベースのサービスプロバイダーが COMM ポートを開く必要はありません。

この手順は TAPI レベルのどのプロシージャにも直接対応していません。TAPI レベルでは、デバイス固有の拡張機能を有効にし、線の特性を選択し、メディアの種類の検出を設定する機能が lineOpen で定義されている機能に含まれています。 TSPI レベルでは、これらの追加機能は、TSPI_lineNegotiateExtVersion、 TSPI_lineSetDefaultMediaDetection 、 TSPI_lineConditionalMediaDetectionに分けられます。