TSPI_lineSetCallParams-Funktion (tspi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |