Função phoneGetRing (tapi.h)
A função phoneGetRing permite que um aplicativo consulte o dispositivo de telefone aberto especificado quanto ao modo de toque atual.
Sintaxe
LONG phoneGetRing(
HPHONE hPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
Parâmetros
hPhone
Identificador para o dispositivo de telefone aberto.
lpdwRingMode
Padrão de toque com o qual o telefone está tocando. Zero indica que o telefone não está tocando.
lpdwVolume
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.
Retornar valor
Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.
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 | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |