função TSPI_phoneSetGain (tspi.h)
A função TSPI_phoneSetGain define o ganho do microfone do dispositivo hookswitch especificado para o nível de ganho especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneSetGain(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
DWORD dwGain
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona.
hdPhone
O identificador para o telefone que contém o dispositivo hookswitch cujo ganho deve ser definido.
dwHookSwitchDev
O dispositivo hookswitch cujo ganho do microfone deve ser definido. Esse parâmetro usa uma e apenas uma das constantes PHONEHOOKSWITCHDEV_.
dwGain
Um local do tamanho DWORD que contém a nova configuração de ganho desejada do dispositivo. 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. Um valor para dwGain que está fora do intervalo é fixado por TAPI ao valor mais próximo no intervalo.
Retornar valor
Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou se for um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |