phoneSetVolume 関数 (tapi.h)
phoneSetVolume 関数は、指定したフックスイッチ デバイスのスピーカー コンポーネントのボリュームを指定したレベルに設定します。
構文
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
パラメーター
hPhone
開いている電話デバイスにハンドルします。 アプリケーションは電話の所有者である必要があります。
dwHookSwitchDev
スピーカーの音量を設定するフックスイッチ デバイス( PHONEHOOKSWITCHDEV_定数のいずれか)。
dwVolume
デバイスの新しいボリューム設定。 dwVolume パラメーターは、フックスイッチ デバイスのボリューム レベルを指定します。 これは、0x00000000 (無音) から0x0000FFFF (最大ボリューム) までの範囲内の数値です。 この範囲のボリューム設定の実際の粒度と量子化は、サービス プロバイダー固有です。 範囲外の dwVolume の値は、範囲内の最も近い値に設定されます。
戻り値
関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応する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 |