次の方法で共有

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

こちらもご覧ください

PHONESTATUS

PHONE_STATE