função TSPI_phoneGetGain (tspi.h)
A função TSPI_phoneGetGain retorna a configuração de ganho do microfone do dispositivo hookswitch do telefone especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneGetGain(
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwGain
);
Parâmetros
hdPhone
O identificador para o telefone cujo ganho deve ser recuperado.
dwHookSwitchDev
O dispositivo hookswitch cujo nível de ganho é consultado. Esse parâmetro pode ser apenas uma das constantes PHONEHOOKSWITCHDEV_.
lpdwGain
Um ponteiro para um local do tamanho de DWORD no qual o provedor de serviços grava a configuração de ganho atual do componente de microfone hookswitch. O parâmetro de ganho dwGain especifica o nível de volume do dispositivo hookswitch. Esse é um número no intervalo de 0x00000000 (silêncio) até 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.
Valor retornado
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |