Função phoneGetRing (tapi.h)

  • Artigo

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

Confira também

Funções complementares do Serviço de Telefonia

Visão geral da referência do TAPI 2.2