TSPI_lineGetDevCaps関数 (tspi.h)

TSPI_lineGetDevCaps関数は、指定された回線デバイスに対してクエリを実行して、テレフォニー機能を判断します。 返される情報は、回線デバイス上のすべてのアドレスに対して有効です。

構文

LONG TSPIAPI TSPI_lineGetDevCaps(
  DWORD         dwDeviceID,
  DWORD         dwTSPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

パラメーター

dwDeviceID

クエリを実行する回線デバイス。

dwTSPIVersion

ネゴシエートされた TSPI バージョン番号。 この値は、 TSPI_lineNegotiateTSPIVersion 関数を介してこのデバイスに対してネゴシエートされています。

dwExtVersion

ネゴシエートされた拡張機能のバージョン番号。 この値は、 TSPI_lineNegotiateExtVersion 関数を使用して、このデバイスに対して既にネゴシエートされています。 このパラメーターは、この関数が呼び出されたときに TAPI によって検証されません。

lpLineDevCaps

LINEDEVCAPS 型の可変サイズの構造体へのポインター。 要求が正常に完了すると、この構造体には回線デバイスの機能情報が入力されます。

戻り値

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM。

注釈

サービス プロバイダーの行デバイス識別子の番号は、TSPI_providerInit関数に渡される dwLineDeviceIDBase パラメーターによって設定された値から順番に行われます。

dwExtVersion 仮パラメーターは、要求された拡張機能情報のバージョン番号を示します。 0 の場合、拡張情報は要求されません。 0 以外の場合は、 TSPI_lineNegotiateExtVersion 関数を使用してこのデバイスに対してネゴシエートされた値が保持されます。 サービス プロバイダーは、指定された拡張機能のバージョンに従って、デバイスおよびベンダー固有の拡張情報を入力します。

サービス プロバイダーは、TAPI によって入力される dwTotalSize を除き、LINEDEVCAPS データ構造のすべてのメンバーを入力します。 サービス プロバイダーは dwTotalSize メンバーを上書きしないでください。

サービス プロバイダーは、 LINETERMCAPS データ構造のすべてのメンバー、または LINEDEVCAPS データ構造のさまざまな部分に埋め込まれた構造体を入力する必要があります。

サービス プロバイダーが TSPI_lineGetDevCaps 関数から戻った後、TAPI は LINEDEVCAPS 構造体の dwLinesStates メンバーを次のように設定します。

LINEDEVCAPS.dwLineStates |=
    LINEDEVSTATE_OPEN |
    LINEDEVSTATE_CLOSE |
    LINEDEVSTATE_REINIT |
    LINEDEVSTATE_TRANSLATECHANGE;

要件

こちらもご覧ください

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit