Função lineSetNumRings (tapi.h)

Artigo
08/26/2023

A função lineSetNumRings define o número de anéis que devem ocorrer antes que uma chamada de entrada seja atendida. Essa função pode ser usada para implementar uma função de estilo toll-saver. Ele permite que vários aplicativos independentes registrem cada um o número de anéis. A linha de funçãoGetNumRings retorna o número mínimo de anéis solicitados. Ele pode ser usado pelo aplicativo que atende chamadas de entrada para determinar o número de anéis que deve aguardar antes de atender à chamada.

Sintaxe

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

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 entre as atualizações do sistema operacional.

dwNumRings

O número de anéis antes de uma chamada deve ser atendido para atender às solicitações de salvamento de pedágio de todos os aplicativos.

Retornar valor

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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentários

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. Se nenhum aplicativo chamar lineSetNumRings, lineGetNumRings retornará 0xFFFFFFFF.

Um aplicativo que é o proprietário de uma chamada no estado de oferta e que recebeu uma mensagem de toque LINE_LINEDEVSTATE deve aguardar vários anéis iguais ao número retornado por lineGetNumRings antes de atender à chamada para respeitar as configurações de salvamento de pedágio em todos os aplicativos. Uma mensagem de toque LINE_LINEDEVSTATE separada é enviada ao aplicativo para cada ciclo de anel, portanto, o aplicativo deve contar essas mensagens. Se essa chamada se desconectar antes de ser atendida e outra chamada for recebida logo depois, a mensagem LINE_CALLSTATE deverá permitir que o aplicativo determine que o toque está relacionado à segunda chamada.

Se a classificação de chamadas for executada pelo TAPI por meio de atender chamadas recebidas de tipo de mídia desconhecido e filtrar o fluxo de mídia, a TAPI também honrará esse número.

Nota Essa operação é puramente informativa e não afeta o estado de nenhuma chamada no dispositivo de linha.