phoneSetGain 関数 (tapi.h)

  • [アーティクル]

phoneSetGain 関数は、指定したフックスイッチ デバイスのマイクのゲインを、指定したゲイン レベルに設定します。

構文

LONG phoneSetGain(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwGain
);

パラメーター

hPhone

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

dwHookSwitchDev

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

dwGain

デバイスの新しいゲイン設定を含む DWORD へのポインター。 dwGain パラメーターは、フックスイッチ デバイスのゲイン レベルを指定します。 これは、0x00000000 (無音) から0x0000FFFF (最大ボリューム) までの範囲内の数値です。 この範囲のゲイン設定の実際の粒度と量子化は、サービス プロバイダー固有です。 範囲外の dwGain の値は、範囲内の最も近い値に設定されます。

戻り値

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

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

要件

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

こちらもご覧ください

PHONE_REPLY

補助電話サービス機能

TAPI 2.2 リファレンスの概要