funzione TSPI_lineSetCallParams (tspi.h)

Articolo
03/03/2024

La funzione TSPI_lineSetCallParams imposta determinati parametri per una chiamata esistente.

Sintassi

LONG TSPIAPI TSPI_lineSetCallParams(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parametri

dwRequestID

Identificatore della richiesta asincrona.

hdCall

Handle alla chiamata i cui parametri devono essere modificati. Lo stato della chiamata può essere qualsiasi stato tranne inattivo e disconnesso.

dwBearerMode

Nuova modalità di connessione per la chiamata. Il parametro dwBearerMode può avere solo una delle costanti LINEBEARERMODE_.

dwMinRate

Limite inferiore per la nuova frequenza di dati della chiamata. TAPI può accettare una nuova tariffa come questa. TAPI non convalida questo parametro quando questa funzione viene chiamata.

dwMaxRate

Limite superiore per la nuova frequenza di dati della chiamata. Si tratta della velocità massima dei dati TAPI. Valori uguali per dwMinRate e dwMaxRate indicano che è necessaria una frequenza di dati esatta. TAPI non convalida questo parametro quando questa funzione viene chiamata.

lpDialParams

Puntatore ai nuovi parametri di composizione per la chiamata, di tipo LINEDIALPARAMS. Se questo parametro è NULL, indica che i parametri di composizione correnti della chiamata devono essere usati.

Valore restituito

Restituisce dwRequestID o un numero di errore se si verifica un errore. Il parametro effettivo lResult del ASYNC_COMPLETION corrispondente è zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

LINEERR_INVALCALLHANDLE, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_NOMEM, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALRATE, LINEERR_RESOURCEUNAVAIL, LINEERR_BEARERMODEUNAVAIL.

Commenti

Questa operazione viene usata per modificare i parametri di una chiamata esistente. Alcuni esempi di utilizzo includono la modifica della modalità di connessione e/o della frequenza dei dati di una chiamata esistente.