funzione lineGetNumRings (tapi.h)

Articolo
03/05/2024

La funzione lineGetNumRings determina il numero di anelli di una chiamata in ingresso sull'indirizzo specificato prima di rispondere alla chiamata.

Sintassi

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

Parametri

hLine

Gestire il dispositivo a riga aperta.

dwAddressID

Indirizzo sul dispositivo della riga. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

lpdwNumRings

Numero di anelli che sono il minimo di tutte le richieste lineSetNumRings correnti.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

Le funzioni lineGetNumRings e lineSetNumRings , quando usate in combinazione, forniscono un meccanismo per supportare l'implementazione di funzionalità di risparmio verde in più applicazioni indipendenti.

Un'applicazione che riceve un handle per una chiamata nello stato dell'offerta e un messaggio diringing LINE_LINEDEVSTATE deve attendere un numero di anelli uguale al numero restituito da lineGetNumRings prima di rispondere alla chiamata per rispettare le impostazioni del risparmio verde in tutte le applicazioni. La funzione lineGetNumRings restituisce il numero minimo di anelli di tutte le applicazioni specificate da lineSetNumRings. Poiché questo numero può variare in modo dinamico, un'applicazione deve richiamare lineGetNumRings ogni volta che ha l'opzione di rispondere a una chiamata. Se nessuna applicazione ha chiamato lineSetNumRings, il numero di anelli restituiti è 0xFFFFFFFF. Viene inviato un messaggio di anello LINE_LINEDEVSTATE separato all'applicazione per ogni ciclo di anello.

Se la classificazione delle chiamate viene eseguita da TAPI per rispondere a tutte le chiamate di modalità multimediale sconosciuta e filtrando il flusso multimediale, TAPI rispetta anche questo numero.

Nota Questa operazione è puramente informativo e non influisce sullo stato delle chiamate sul dispositivo line.