lineGetDevCaps 関数 (tapi.h)

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

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 を使用して、各アドレスの正確な機能を判断します。アドレス識別子はアドレスと永続的に関連付けられていることに注意してください。識別子はオペレーティングシステムのアップグレード全体で一定のままです。