lineGetDevCaps 関数は、指定された回線デバイスを照会してテレフォニー機能を判断します。 返される情報は、回線デバイス上のすべてのアドレスに対して有効です。
構文
LONG lineGetDevCapsW(
HLINEAPP hLineApp,
DWORD dwDeviceID,
DWORD dwAPIVersion,
DWORD dwExtVersion,
LPLINEDEVCAPS lpLineDevCaps
);
パラメーター
hLineApp
TAPI を使用してアプリケーションの登録を処理します。
dwDeviceID
クエリを実行する回線デバイスの識別子。
dwAPIVersion
使用するテレフォニー API のバージョン番号。 上位ワードにはメジャー バージョン番号が含まれています。下位ワードにはマイナー バージョン番号が含まれています。 この数値は、lineNegotiateAPIVersionを
dwExtVersion
使用するサービス プロバイダー固有の拡張機能のバージョン番号。 この数値は、lineNegotiateExtVersionを
lpLineDevCaps
LINEDEVCAPS
構造体のサイズ パラメーターが正しくない場合、データが上書きされる可能性があります。 構造体サイズの設定の詳細については、メモリ割り当て トピックを参照してください。
戻り値
要求が成功した場合は 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 未満に変わります。 各アドレスの機能は異なる場合があります。 使用可能な各
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetDevCaps を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
lineGetAddressCaps を
lineNegotiateExtVersion を