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 |