Função phoneSetGain (tapi.h)
A função phoneSetGain define o ganho do microfone do dispositivo hookswitch especificado para o nível de ganho especificado.
Sintaxe
LONG phoneSetGain(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwGain
);
Parâmetros
hPhone
Identificador para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do telefone.
dwHookSwitchDev
Dispositivo Hookswitch cujo ganho do microfone deve ser definido. Esse parâmetro usa uma e apenas uma das constantes PHONEHOOKSWITCHDEV_.
dwGain
Ponteiro para um DWORD que contém a nova configuração de ganho do dispositivo. O parâmetro dwGain especifica o nível de ganho do dispositivo hookswitch. Esse é um número no intervalo 0x00000000 (silêncio) para 0x0000FFFF (volume máximo). A granularidade real e a quantização das configurações de ganho nesse intervalo são específicas do provedor de serviços. Um valor para dwGain que está fora do intervalo é definido como o valor mais próximo no intervalo.
Retornar valor
Retornará um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de PHONE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |