TSPI_phoneSetButtonInfo関数 (tspi.h)

[アーティクル]
03/03/2024

TSPI_phoneSetButtonInfo関数は、指定した電話の指定したボタンに関する情報を設定します。

構文

LONG TSPIAPI TSPI_phoneSetButtonInfo(
  DRV_REQUESTID           dwRequestID,
  HDRVPHONE               hdPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

パラメーター

dwRequestID

非同期要求の識別子。関数が非同期的に完了すると、サービスプロバイダーはこの値を返します。

hdPhone

ボタン情報を設定する電話のハンドル。

dwButtonLampID

電話デバイスのボタン。

lpButtonInfo

PHONEBUTTONINFO 型の可変サイズの構造体へのポインター。このデータ構造では、モードと関数について説明し、ボタンに設定する追加の説明テキストを提供します。

戻り値

関数が非同期的に完了した場合は (正の) dwRequestID 値を返し、エラーが発生した場合はエラー番号を返します。関数が成功した場合は対応するASYNC_COMPLETIONの実際のパラメーター lResult は 0、エラーが発生した場合はエラー番号です。可能な戻り値は次のとおりです。

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