次の方法で共有


TSPI_lineOpen関数 (tspi.h)

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_lineNegotiateExtVersionTSPI_lineSetDefaultMediaDetectionTSPI_lineConditionalMediaDetectionに分けられます。

要件

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

こちらもご覧ください

LINEEVENT

LINE_CLOSE

TSPI_lineClose

TSPI_lineConditionalMediaDetection

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_lineSetDefaultMediaDetection