phoneGetHookSwitch 関数 (tapi.h)

phoneGetHookSwitch 関数は、指定された開いている電話デバイスの現在のフックスイッチ モードを返します。

構文

LONG phoneGetHookSwitch(
  HPHONE  hPhone,
  LPDWORD lpdwHookSwitchDevs
);

パラメーター

hPhone

開いている電話デバイスにハンドルします。

lpdwHookSwitchDevs

電話のフックスイッチ デバイスのモードで塗りつぶされる DWORD へのポインター。 ビット位置が FALSE の場合、対応するフックスイッチ デバイスは onhook です。 TRUE の場合、対応するフックスイッチ デバイスのマイクやスピーカー部分がオフフックになります。 マイクまたはスピーカーが有効になっているかどうかを調べるには、アプリケーションで phoneGetStatus を使用できます。 このパラメーターでは、1 つ以上の PHONEHOOKSWITCHDEV_定数を使用します

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_OPERATIONUNAVAIL、PHONEERR_UNINITIALIZED。

注釈

デバイスのフックスイッチの状態が変わり、フックスイッチの監視が有効になっている場合、アプリケーションは PHONE_STATE メッセージを送信します。

要件

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

こちらもご覧ください

PHONE_STATE

補助電話サービス機能

TAPI 2.2 リファレンスの概要

phoneGetStatus