TSPI_phoneGetDevCaps関数 (tspi.h)

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

構文

LONG TSPIAPI TSPI_phoneGetDevCaps(
  DWORD       dwDeviceID,
  DWORD       dwTSPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

パラメーター

dwDeviceID

クエリを実行する電話デバイス。

dwTSPIVersion

ネゴシエートされた TSPI バージョン番号。 この値は、 TSPI_phoneNegotiateTSPIVersion 関数を介してこのデバイスに対してネゴシエートされます。

dwExtVersion

ネゴシエートされた拡張機能のバージョン番号。 この値は、 TSPI_phoneNegotiateExtVersion 関数を介してこのデバイスに対してネゴシエートされます。

lpPhoneCaps

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

戻り値

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

PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_OPERATIONFAILED、PHONEERR_NODRIVER、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOMEM。

注釈

サービス プロバイダーは、TAPI によって入力される dwTotalSize を除き、PHONEBUTTONINFO データ構造のすべてのメンバーを入力します。 サービス プロバイダーは dwTotalSize メンバーを上書きしないでください。

dwExtVersion が 0 の場合、拡張情報は要求されません。 0 以外の場合は、 TSPI_phoneNegotiateExtVersion 関数を使用してこのデバイスに対してネゴシエート済みの値が保持されます。 サービス プロバイダーは、指定された拡張機能のバージョンに従って、デバイスおよびベンダー固有の拡張情報を入力します。

サービス プロバイダーが TSPI_phoneGetDevCaps 関数から戻った後、TAPI は PHONECAPS 構造体の dwPhoneStates メンバーを次のように設定します。

PHONECAPS.dwPhoneStates |=
    PHONESTATE_OWNER |
    PHONESTATE_MONITORS |
    PHONESTATE_REINIT;

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	tspi.h

こちらもご覧ください

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneNegotiateExtVersion