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

Confira também

PHONE_REPLY

Funções complementares do Serviço de Telefonia

Visão geral da referência do TAPI 2.2