função TSPI_phoneSetRing (tspi.h)
A função TSPI_phoneSetRing toca o dispositivo de telefone aberto especificado usando o modo de anel e o volume especificados.
Sintaxe
LONG TSPIAPI TSPI_phoneSetRing(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwRingMode,
DWORD dwVolume
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona.
hdPhone
O identificador do telefone a ser tocado.
dwRingMode
O 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 a dwNumRingModes são modos de toque válidos para o dispositivo de telefone.
dwVolume
O nível de volume com o qual o telefone deve ser tocado. 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 volume nesse intervalo são específicas do provedor de serviços. Um valor para dwVolume que está fora do intervalo é fixado por TAPI ao valor mais próximo no intervalo.
Valor retornado
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_INVALRINGMODE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Comentários
O provedor de serviços define os padrões de toque audíveis reais correspondentes a cada um dos modos de toque do telefone.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |