次の方法で共有


phoneSetHookSwitch 関数 (tapi.h)

phoneSetHookSwitch 関数は、指定したオープンフォンのフックスイッチ デバイスのフック状態を指定したモードに設定します。 一覧表示されているフックスイッチ デバイスのフックスイッチの状態のみが影響を受ける。

構文

LONG phoneSetHookSwitch(
  HPHONE hPhone,
  DWORD  dwHookSwitchDevs,
  DWORD  dwHookSwitchMode
);

パラメーター

hPhone

開いている電話デバイスにハンドルします。 アプリケーションは電話の所有者である必要があります。

dwHookSwitchDevs

フックスイッチ モードを設定するデバイス。 このパラメーターは、 PHONEHOOKSWITCHDEV_定数の 1 つだけを使用します。

PHONEHOOKSWITCHDEV_HANDSET

電話の受話器。

PHONEHOOKSWITCHDEV_SPEAKER

電話のスピーカーフォンまたは付属の電話。

PHONEHOOKSWITCHDEV_HEADSET

電話機のヘッドセット。

dwHookSwitchMode

設定するフックスイッチ モード。 このパラメーターは、 PHONEHOOKSWITCHMODE_定数の 1 つだけを使用します。

PHONEHOOKSWITCHMODE_ONHOOK

デバイスのマイクとスピーカーは両方ともオンフックです。

PHONEHOOKSWITCHMODE_MIC

デバイスのマイクがアクティブで、スピーカーがミュートです。

PHONEHOOKSWITCHMODE_SPEAKER

デバイスのスピーカーがアクティブで、マイクがミュートです。

PHONEHOOKSWITCHMODE_MICSPEAKER

デバイスのマイクとスピーカーの両方がアクティブです。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応するPHONE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。 可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOTOWNER、PHONEERR_NOMEM、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALHOOKSWITCHMODE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_UNINITIALIZED。

注釈

フックスイッチ モードは、指定されたすべてのデバイスで同じです。 異なる設定が必要な場合、この関数は異なるパラメーター セットを使用して複数回呼び出すことができます。 PHONE_STATE メッセージは、フックスイッチの状態が変更された後にアプリケーションに送信されます。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

PHONE_REPLY

PHONE_STATE

補助電話サービス機能

TAPI 2.2 リファレンスの概要