função TSPI_phoneGetRing (tspi.h)
A função TSPI_phoneGetRing permite que um aplicativo consulte o dispositivo de telefone aberto especificado quanto ao modo de anel atual.
Sintaxe
LONG TSPIAPI TSPI_phoneGetRing(
HDRVPHONE hdPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
Parâmetros
hdPhone
O identificador para o telefone cujo modo de toque deve ser consultado.
lpdwRingMode
O padrão de toque com o qual o telefone está tocando. Zero indica que o telefone não está tocando.
lpdwVolume
O nível de volume com o qual o telefone está tocando. 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.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |