TSPI_lineGetCallInfo-Funktion (tspi.h)

Artikel
03/06/2024

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

Share via