Função phoneGetGain (tapi.h)
A função phoneGetGain retorna a configuração de ganho do microfone do dispositivo hookswitch do telefone especificado.
Sintaxe
LONG phoneGetGain(
HPHONE hPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwGain
);
Parâmetros
hPhone
Manipule para o dispositivo de telefone aberto.
dwHookSwitchDev
Dispositivo Hookswitch cujo nível de ganho é consultado. O parâmetro dwHookSwitchDev pode ter apenas um bit definido. Esse parâmetro usa uma e apenas uma das constantes PHONEHOOKSWITCHDEV_.
lpdwGain
Ponteiro para um DWORD que contém a configuração de ganho atual do componente de microfone hookswitch. O parâmetro dwGain especifica o nível de volume 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.
Retornar valor
Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, 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 |