lineSetCallParams-Funktion (tapi.h)

Artikel
08/26/2023

Die lineSetCallParams-Funktion ermöglicht es einer Anwendung, den Bearermodus und/oder die Ratenparameter eines vorhandenen Aufrufs zu ändern.

Syntax

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

Parameter

hCall

Handle an den Aufruf, dessen Parameter geändert werden sollen. Die Anwendung muss besitzer des Aufrufs sein. Der Anrufstatus von hCall kann ein beliebiger Zustand sein, außer im Leerlauf oder getrennt.

dwBearerMode

Neuer Bearermodus für den Anruf. Dieser Parameter verwendet nur eine der LINEBEARERMODE_ Konstanten.

dwMinRate

Untergrenze für die neue Datenrate des Anrufs. Die Anwendung kann eine neue Rate akzeptieren, die so niedrig ist wie diese.

dwMaxRate

Obergrenze für die neue Datenrate des Aufrufs. Dies ist die maximale Datenrate, die die Anwendung akzeptieren kann. Wenn eine genaue Datenrate erforderlich ist, sollten dwMinRate und dwMaxRate gleich sein.

lpDialParams

Zeiger auf die neuen Wählparameter für den Anruf vom Typ LINEDIALPARAMS. Dieser Parameter kann NULL belassen werden, wenn die aktuellen Wählparameter des Aufrufs verwendet werden sollen.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

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.

Hinweise

Dieser Vorgang wird verwendet, um die Parameter eines vorhandenen Aufrufs zu ändern. Beispiele für die Verwendung sind das Ändern des Bearermodus und/oder der Datenrate eines vorhandenen Aufrufs.