phoneGetGain 関数 (tapi.h)
phoneGetGain 関数は、指定された電話のフックスイッチ デバイスのマイクのゲイン設定を返します。
構文
LONG phoneGetGain(
HPHONE hPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwGain
);
パラメーター
hPhone
開いている電話デバイスにハンドルします。
dwHookSwitchDev
ゲイン レベルが照会されるフックスイッチ デバイス。 dwHookSwitchDev パラメーターに設定できるビットは 1 つだけです。 このパラメーターは、 PHONEHOOKSWITCHDEV_定数の 1 つだけを使用します。
lpdwGain
フックスイッチ マイク コンポーネントの現在のゲイン設定を含む DWORD へのポインター。 dwGain パラメーターは、フックスイッチ デバイスのボリューム レベルを指定します。 これは、0x0000FFFF (最大ボリューム) に0x00000000 (無音) の範囲内の数値です。 この範囲のゲイン設定の実際の粒度と量子化は、サービス プロバイダー固有です。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi.h |
Library | Tapi32.lib |
[DLL] | Tapi32.dll |