Funzione lineSetCallParams (tapi.h)

Articolo
08/26/2023

La funzione lineSetCallParams consente a un'applicazione di modificare la modalità di connessione e/o i parametri di frequenza di una chiamata esistente.

Sintassi

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parametri

hCall

Handle per la chiamata i cui parametri devono essere modificati. L'applicazione deve essere un proprietario della chiamata. Lo stato della chiamata di hCall può essere qualsiasi stato tranne inattivo o disconnesso.

dwBearerMode

Nuova modalità di connessione per la chiamata. Questo parametro usa una e una sola delle costanti LINEBEARERMODE_.

dwMinRate

Limite inferiore per la nuova frequenza dei dati della chiamata. L'applicazione può accettare una nuova tariffa così come questa.

dwMaxRate

Limite superiore per la nuova frequenza dei dati della chiamata. Si tratta della frequenza massima di dati che l'applicazione può accettare. Se è necessaria una frequenza di dati esatta, dwMinRate e dwMaxRate devono essere uguali.

lpDialParams

Puntatore ai nuovi parametri di composizione per la chiamata, di tipo LINEDIALPARAMS. Questo parametro può essere lasciato NULL se devono essere utilizzati i parametri di composizione correnti della chiamata.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di LINE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

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