phoneGetDevCaps 関数 (tapi.h)

  • [アーティクル]

phoneGetDevCaps 関数は、指定された電話デバイスに対してクエリを実行して、テレフォニー機能を決定します。

構文

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

パラメーター

hPhoneApp

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

dwDeviceID

照会する電話デバイスの識別子。

dwAPIVersion

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

dwExtVersion

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

lpPhoneCaps

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

戻り値

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

PHONEERR_INVALAPPHANDLE、PHONEERR_INVALPOINTER、PHONEERR_BADDEVICEID、PHONEERR_OPERATIONFAILED、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_NOMEM、PHONEERR_STRUCTURETOOSMALL、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_UNINITIALIZED、PHONEERR_NODEVICE。

解説

phoneGetDevCaps を使用する前に、アプリケーションで使用する TAPI バージョン番号 (phoneNegotiateAPIVersion を参照) と、必要に応じて使用する拡張機能バージョンをネゴシエートする必要があります (phoneNegotiateExtVersion を参照)。

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

要件

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

関連項目

PHONECAPS

補助電話サービス機能

TAPI 2.2 リファレンスの概要

phoneNegotiateAPIVersion

phoneNegotiateExtVersion