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 |