TSPI_lineGetCallInfo-Funktion (tspi.h)
Die TSPI_lineGetCallInfo-Funktion gibt detaillierte Informationen zum angegebenen Aufruf zurück.
Syntax
LONG TSPIAPI TSPI_lineGetCallInfo(
HDRVCALL hdCall,
LPLINECALLINFO lpCallInfo
);
Parameter
hdCall
Das Handle des Dienstanbieters für den Aufruf, dessen Anrufinformationen abgerufen werden sollen. Der Aufrufstatus von hdCall kann ein beliebiger Zustand sein.
lpCallInfo
Ein Zeiger auf eine Datenstruktur vom Typ LINECALLINFO mit unterschiedlicher Größe. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit anrufbezogenen Informationen gefüllt.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Hinweise
Die folgende Tabelle gibt an, welche Member der LINECALLINFO-Datenstruktur von TAPI ausgefüllt werden und welche Member vom Dienstanbieter ausgefüllt werden. Der Dienstanbieter muss die von TAPI ausgefüllten Werte beibehalten (darf nicht überschrieben werden).
| Membername | TAPI | Dienstanbieter |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| hLine; | X | |
| dwLineDeviceID; | X | |
| dwAddressID; | X | |
| dwBearerMode; | X | |
| dwRate; | X | |
| dwMediaMode; | X | |
| dwAppSpecific; | X | |
| dwCallID; | X | |
| dwRelatedCallID; | X | |
| dwCallParamFlags; | X | |
| dwCallStates; | X | X |
| dwMonitorDigitModes; | X | |
| dwMonitorMediaModes; | X | |
| DialParams; | X | |
| dwOrigin; | X | |
| dwReason; | X | |
| dwCompletionID; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwCountryCode; | X | |
| dwTrunk; | X | |
| dwCallerIDFlags; | X | |
| dwCallerIDSize; | X | |
| dwCallerIDOffset; | X | |
| dwCallerIDNameSize; | X | |
| dwCallerIDNameOffset; | X | |
| dwCalledIDFlags; | X | |
| dwCalledIDSize; | X | |
| dwCalledIDOffset; | X | |
| dwCalledIDNameSize; | X | |
| dwCalledIDNameOffset; | X | |
| dwConnectedIDFlags; | X | |
| dwConnectedIDSize; | X | |
| dwConnectedIDOffset; | X | |
| dwConnectedIDNameSize; | X | |
| dwConnectedIDNameOffset; | X | |
| dwRedirectionIDFlags; | X | |
| dwRedirectionIDSize; | X | |
| dwRedirectionIDOffset; | X | |
| dwRedirectionIDNameSize; | X | |
| dwRedirectionIDNameOffset; | X | |
| dwRedirectingIDFlags; | X | |
| dwRedirectingIDSize; | X | |
| dwRedirectingIDOffset; | X | |
| dwRedirectingIDNameSize; | X | |
| dwRedirectingIDNameOffset; | X | |
| dwAppNameSize; | X | |
| dwAppNameOffset; | X | |
| dwDisplayableAddressSize; | X | |
| dwDisplayableAddressOffset; | X | |
| dwCalledPartySize; | X | |
| dwCalledPartyOffset; | X | |
| dwCommentSize; | X | |
| dwCommentOffset; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwUserUserInfoSize; | X | |
| dwUserUserInfoOffset; | X | |
| dwHighLevelCompSize; | X | |
| dwHighLevelCompOffset; | X | |
| dwLowLevelCompSize; | X | |
| dwLowLevelCompOffset; | X | |
| dwChargingInfoSize; | X | |
| dwChargingInfoOffset; | X | |
| dwTerminalModesSize; | X | |
| dwTerminalModesOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI füllt die Felder größe und offset für die Member dwAppNameSize/Offset, dwCalledPartySize/Offset und dwCommentSize/Offset aus und aktualisiert den Wert in dwUsedSize , um diese nach dem Aufruf des Dienstanbieters widerzuspiegeln.
Nachdem der Dienstanbieter die funktion TSPI_lineGetCallInfo zurückgegeben hat, legt TAPI den dwCallStates-Member der LINECALLINFO-Struktur wie folgt fest:
LINECALLINFO.dwCallStates |= LINECALLSTATE_UNKNOWN;
Wenn der Dienstanbieter Zeilen als "Pools" von Kanalressourcen modelliert und ein umgekehrtes Multiplexing eines Aufrufs über mehrere Adressbezeichner ausführt, sollte er konsistent einen dieser Adressbezeichner als primären Bezeichner auswählen, der von dieser Funktion in der LINECALLINFO-Datenstruktur gemeldet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |