TSPI_phoneGetStatus関数 (tspi.h)
TSPI_phoneGetStatus関数は、指定された開いている電話デバイスの全体的な状態を照会します。
構文
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
パラメーター
hdPhone
照会する電話へのハンドル。
lpPhoneStatus
サービス プロバイダーが電話の状態に関する情報を書き込む 、PHONESTATUS 型の可変サイズのデータ構造へのポインター。 アプリケーションは、TSPI_phoneGetStatusを呼び出す前に、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示します。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。
注釈
次の表は、 TAPI によって入力される PHONESTATUS データ構造のメンバーと、サービス プロバイダーによって入力されるメンバーを示しています。 サービス プロバイダーは、TAPI によって入力された値を上書きしないでください。
| メンバー | Tapi | サービス プロバイダー |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwStatusFlags; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwRingMode; | X | |
| dwRingVolume; | X | |
| dwHandsetHookSwitchMode; | X | |
| dwHandsetVolume; | X | |
| dwHandsetGain; | X | |
| dwSpeakerHookSwitchMode; | X | |
| dwSpeakerVolume; | X | |
| dwSpeakerGain; | X | |
| dwHeadsetHookSwitchMode; | X | |
| dwHeadsetVolume; | X | |
| dwHeadsetGain; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwLampModesSize; | X | |
| dwLampModesOffset; | X | |
| dwOwnerNameSize; | X | |
| dwOwnerNameOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI は、この機能を使用して、開いている電話デバイスの現在の状態を判断できます。 状態情報は、電話デバイスのフックスイッチ デバイス、呼び出し音、音量、ディスプレイ、および開いている電話のランプに関する情報を記述します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |