TSPI_phoneGetButtonInfo関数 (tspi.h)

  • [アーティクル]

TSPI_phoneGetButtonInfo関数は、指定したボタンに関する情報を返します。

構文

LONG TSPIAPI TSPI_phoneGetButtonInfo(
  HDRVPHONE         hdPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

パラメーター

hdPhone

クエリを実行する電話へのハンドル。

dwButtonLampID

電話デバイスのボタン。

lpButtonInfo

サービス プロバイダーが PHONEBUTTONINFO 型の可変サイズの構造体を書き込むメモリへのポインター。 このデータ構造は、モードと関数を記述し、ボタンに対応する追加の説明テキストを提供します。 アプリケーションは、TSPI_phoneGetButtonInfoを呼び出す前に、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示します。

戻り値

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

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALBUTTONLAMPID、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NOMEM。

注釈

サービス プロバイダーがボタン情報を含むメモリにアクセスできない場合、 TSPI_phoneGetButtonInfo 関数はPHONEERR_NOMEM値を返します。

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

要件

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

こちらもご覧ください

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneSetButtonInfo