次の方法で共有


lineGetDevCaps 関数 (tapi.h)

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

構文

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

パラメーター

hLineApp

TAPI を使用してアプリケーションの登録を処理します。

dwDeviceID

クエリを実行する回線デバイスの識別子。

dwAPIVersion

使用するテレフォニー API のバージョン番号。 上位の単語にはメジャー バージョン番号が含まれています。下位ワードにはマイナー バージョン番号が含まれています。 この数値は lineNegotiateAPIVersion によって取得されます。

dwExtVersion

使用するサービス プロバイダー固有の拡張機能のバージョン番号。 この数値は lineNegotiateExtVersion によって取得されます。 デバイス固有の拡張機能を使用しない場合は、0 のままにすることができます。 それ以外の場合、上位の単語にはメジャー バージョン番号が含まれます。下位ワードにはマイナー バージョン番号が含まれています。

lpLineDevCaps

LINEDEVCAPS 型の可変サイズの構造体へのポインター。 要求が正常に完了すると、この構造体には回線デバイスの機能情報が入力されます。 lineGetDevCaps を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

メモ 構造体のサイズ パラメーターが正しくない場合は、データが上書きされる可能性があります。 構造体のサイズの設定の詳細については、 メモリ割り当て に関するトピックを参照してください。
 

戻り値

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

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONFAILED、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALAPPHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NODRIVER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODEVICE。

注釈

lineGetDevCaps を使用する前に、アプリケーションで使用する API バージョン番号と、必要に応じて使用する拡張機能のバージョンをネゴシエートする必要があります。

API と拡張機能のバージョン番号は、TAPI とサービス プロバイダーが動作する必要がある番号です。 バージョン範囲が重複しない場合、アプリケーション、API、またはサービス プロバイダーのバージョンに互換性がなく、エラーが返されます。

この関数によって返される LINEDEVCAPS 構造体のメンバーの 1 つに、指定された回線デバイスに割り当てられたアドレスの数が含まれています。 個々のアドレスを参照するために使用される実際のアドレス識別子は、返される数値より 0 から 1 小さいまで異なります。 各アドレスの機能は異なる場合があります。 使用可能な <dwDeviceID、dwAddressID> の組み合わせごとに lineGetAddressCaps を使用して、各アドレスの正確な機能を判断します。 アドレス識別子はアドレスと永続的に関連付けられていることに注意してください。識別子はオペレーティング システムのアップグレード全体で一定のままです。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

基本的なテレフォニー サービス リファレンス

LINEDEVCAPS

TAPI 2.2 リファレンスの概要

lineGetAddressCaps

lineNegotiateAPIVersion

lineNegotiateExtVersion