phoneGetDevCapsA 関数 (tapi.h)

phoneGetDevCaps 関数は、指定された電話デバイスを照会してテレフォニー機能を判断します。

構文

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

パラメーター

hPhoneApp

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

dwDeviceID

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

dwAPIVersion

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

dwExtVersion

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

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 またはサービス プロバイダーのバージョンに互換性がありません。エラーが返されます。

手記

tapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして phoneGetDevCaps を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー tapi.h
ライブラリ Tapi32.lib
DLL Tapi32.dll

関連項目

PHONECAPS

補足電話サービス機能

TAPI 2.2 リファレンスの概要

phoneNegotiateAPIVersion を する

phoneNegotiateExtVersion を する

  • Last updated on