Função lineGetNumRings (tapi.h)

A função lineGetNumRings determina o número de anéis que uma chamada de entrada no endereço especificado deve tocar antes de atender à chamada.

Sintaxe

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

Parâmetros

hLine

Manipule para o dispositivo de linha aberta.

dwAddressID

Endereço no dispositivo de linha. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante em atualizações do sistema operacional.

lpdwNumRings

Número de anéis que é o mínimo de todas as solicitações lineSetNumRings atuais.

Valor de retorno

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Observações

As funções lineGetNumRings e lineSetNumRings, quando usadas em combinação, fornecem um mecanismo para dar suporte à implementação de recursos de salvamento de pedágio em vários aplicativos independentes.

Um aplicativo que recebe um identificador para uma chamada no oferecendo estado e uma mensagem LINE_LINEDEVSTATEtocando deve aguardar vários anéis iguais ao número retornado por lineGetNumRings antes de atender à chamada para honrar as configurações de salvamento de pedágio em todos os aplicativos. A função lineGetNumRings retorna o mínimo do número de anéis de todos os aplicativos especificado por lineSetNumRings. Como esse número pode variar dinamicamente, um aplicativo deve invocar lineGetNumRings sempre que tiver a opção de responder a uma chamada. Se nenhum aplicativo tiver chamado lineSetNumRings, o número de anéis retornados será 0xFFFFFFFF. Uma mensagem de toque LINE_LINEDEVSTATE separada é enviada ao aplicativo para cada ciclo de anel.

Se a classificação de chamadas for executada pela TAPI para atender a todas as chamadas do modo de mídia desconhecido e filtrar o fluxo de mídia, o TAPI também honrará esse número.

Observação Essa operação é puramente informativa e, por si só, não afeta o estado de nenhuma chamada no dispositivo de linha.

 

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

Referência dos Serviços básicos de telefonia

LINE_LINEDEVSTATE

visão geral de referência do TAPI 2.2

lineSetNumRings