Função phoneSetRing (tapi.h)

Artigo
03/02/2024

A função phoneSetRing toca o dispositivo de telefone aberto especificado usando o modo de toque e o volume especificados.

Sintaxe

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

Parâmetros

hPhone

Identificador para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do dispositivo de telefone.

dwRingMode

Padrão de toque com o qual tocar o telefone. Esse parâmetro deve estar dentro do intervalo de zero até o valor do membro dwNumRingModes na estrutura PHONECAPS . Se dwNumRingModes for zero, o modo de toque do telefone não poderá ser controlado; se dwNumRingModes for 1, um valor de 0 para dwRingMode indicará que o telefone não deve ser tocado (silêncio) e outros valores de 1 para dwNumRingModes são modos de toque válidos para o dispositivo de telefone.

dwVolume

Nível de volume com o qual o telefone está tocando. 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_INVALRINGMODE, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL.