Função phoneSetVolume (tapi.h)
A função phoneSetVolume define o volume do componente do alto-falante do dispositivo hookswitch especificado para o nível especificado.
Sintaxe
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Parâmetros
hPhone
Identificador para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do telefone.
dwHookSwitchDev
Dispositivo Hookswitch cujo volume do alto-falante deve ser definido, uma das constantes PHONEHOOKSWITCHDEV_.
dwVolume
Nova configuração de volume do dispositivo. O parâmetro dwVolume 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 volume nesse intervalo são específicas do provedor de serviços. Um valor para dwVolume 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 |