TSPI_lineSetCallParams-Funktion (tspi.h)

Artikel
08/26/2023

Die TSPI_lineSetCallParams-Funktion legt bestimmte Parameter für einen vorhandenen Aufruf fest.

Syntax

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

Parameter

dwRequestID

Der Bezeichner der asynchronen Anforderung.

hdCall

Das Handle für den Aufruf, dessen Parameter geändert werden sollen. Der Anrufstatus kann ein beliebiger Zustand sein, außer im Leerlauf und getrennt.

dwBearerMode

Der neue Bearermodus für den Anruf. Der dwBearerMode-Parameter kann nur eine der LINEBEARERMODE_ Konstanten aufweisen.

dwMinRate

Eine Untergrenze für die neue Datenrate des Aufrufs. TAPI kann eine neue Rate akzeptieren, die so niedrig ist wie diese. TAPI überprüft diesen Parameter nicht, wenn diese Funktion aufgerufen wird.

dwMaxRate

Eine Obergrenze für die neue Datenrate des Aufrufs. Dies ist die maximale Datenrate, die TAPI wünscht. Gleiche Werte für dwMinRate und dwMaxRate geben an, dass eine genaue Datenrate erforderlich ist. TAPI überprüft diesen Parameter nicht, wenn diese Funktion aufgerufen wird.

lpDialParams

Ein Zeiger auf die neuen Wählparameter für den Aufruf vom Typ LINEDIALPARAMS. Wenn dieser Parameter NULL ist, gibt er an, dass die aktuellen Wählparameter des Aufrufs verwendet werden sollen.

Rückgabewert

Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter des entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:

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

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.