LINECALLINFO-Struktur (tapi.h)
Die LINECALLINFO-Struktur enthält Informationen zu einem Aufruf. Diese Informationen bleiben für die Dauer des Anrufs relativ fest. Mehrere Funktionen verwenden LINECALLINFO. Die -Struktur wird von der lineGetCallInfo-Funktion und der TSPI_lineGetCallInfo-Funktion zurückgegeben. Wenn sich ein Teil der Struktur ändert, wird eine LINE_CALLINFO Nachricht an die Anwendung gesendet, die angibt, welches Informationselement geändert wurde.
Dynamisch ändernde Informationen zu einem Aufruf, z. B. anrufstatus status, sind in der LINECALLSTATUS-Struktur verfügbar, die von einem Aufruf der lineGetCallStatus-Funktion zurückgegeben wird.
Syntax
typedef struct linecallinfo_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
HLINE hLine;
DWORD dwLineDeviceID;
DWORD dwAddressID;
DWORD dwBearerMode;
DWORD dwRate;
DWORD dwMediaMode;
DWORD dwAppSpecific;
DWORD dwCallID;
DWORD dwRelatedCallID;
DWORD dwCallParamFlags;
DWORD dwCallStates;
DWORD dwMonitorDigitModes;
DWORD dwMonitorMediaModes;
LINEDIALPARAMS DialParams;
DWORD dwOrigin;
DWORD dwReason;
DWORD dwCompletionID;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwCountryCode;
DWORD dwTrunk;
DWORD dwCallerIDFlags;
DWORD dwCallerIDSize;
DWORD dwCallerIDOffset;
DWORD dwCallerIDNameSize;
DWORD dwCallerIDNameOffset;
DWORD dwCalledIDFlags;
DWORD dwCalledIDSize;
DWORD dwCalledIDOffset;
DWORD dwCalledIDNameSize;
DWORD dwCalledIDNameOffset;
DWORD dwConnectedIDFlags;
DWORD dwConnectedIDSize;
DWORD dwConnectedIDOffset;
DWORD dwConnectedIDNameSize;
DWORD dwConnectedIDNameOffset;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectionIDSize;
DWORD dwRedirectionIDOffset;
DWORD dwRedirectionIDNameSize;
DWORD dwRedirectionIDNameOffset;
DWORD dwRedirectingIDFlags;
DWORD dwRedirectingIDSize;
DWORD dwRedirectingIDOffset;
DWORD dwRedirectingIDNameSize;
DWORD dwRedirectingIDNameOffset;
DWORD dwAppNameSize;
DWORD dwAppNameOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwChargingInfoSize;
DWORD dwChargingInfoOffset;
DWORD dwTerminalModesSize;
DWORD dwTerminalModesOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwCallTreatment;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwCallerIDAddressType;
DWORD dwCalledIDAddressType;
DWORD dwConnectedIDAddressType;
DWORD dwRedirectionIDAddressType;
DWORD dwRedirectingIDAddressType;
} LINECALLINFO, *LPLINECALLINFO;
Member
dwTotalSize
Dieser Datenstruktur zugeordnete Gesamtgröße in Byte.
dwNeededSize
Größe für diese Datenstruktur, die benötigt wird, um alle zurückgegebenen Informationen in Bytes zu enthalten.
dwUsedSize
Größe des Teils dieser Datenstruktur, der nützliche Informationen in Byte enthält.
hLine
Handle an das Leitungsgerät, dem dieser Aufruf zugeordnet ist.
dwLineDeviceID
Gerätebezeichner des Leitungsgeräts, dem dieser Aufruf zugeordnet ist.
dwAddressID
Adressbezeichner der Adresse in der Zeile, in der dieser Aufruf vorhanden ist. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.
dwBearerMode
Aktueller Bearermodus des Aufrufs. Dieser Member verwendet eine der LINEBEARERMODE_ Konstanten.
dwRate
Rate des Datenstroms des Aufrufs in Bps (Bits pro Sekunde).
dwMediaMode
Medientyp des Informationsstreams, der sich derzeit im Anruf befindet. Dies ist der Medientyp, der vom Besitzer des Anrufs bestimmt wird, der nicht unbedingt mit dem der letzten LINE_MONITORMEDIA Nachricht identisch ist. Dieses Element ist nicht direkt von den LINE_MONITORMEDIA Nachrichten betroffen. Dieser Member verwendet die LINEMEDIAMODE_ Konstanten.
dwAppSpecific
Wird nicht von der API-Implementierung und dem Dienstanbieter interpretiert. Sie kann von jeder Besitzeranwendung dieses Aufrufs mit der lineSetAppSpecific-Funktion festgelegt werden.
dwCallID
In einigen Telefonieumgebungen kann der Switch oder Dienstanbieter jedem Anruf einen eindeutigen Bezeichner zuweisen. Dadurch kann der Anruf über Übertragungen, Weiterleitungen oder andere Ereignisse hinweg nachverfolgt werden. Die Domäne dieser Aufruf-IDs und ihr Bereich ist vom Dienstanbieter definiert. Das dwCallID-Element stellt diesen eindeutigen Bezeichner für die Anwendungen zur Verfügung.
dwRelatedCallID
In Telefonieumgebungen, in denen die Anruf-ID verwendet wird, ist es häufig erforderlich, einen Anruf mit einem anderen zu verknüpfen. Das dwRelatedCallID-Mitglied kann vom Dienstanbieter zu diesem Zweck verwendet werden.
dwCallParamFlags
Sammlung von aufrufbezogenen Parametern, wenn der Aufruf ausgehend ist. Dies sind die gleichen Aufrufparameter, die in lineMakeCall angegeben sind, einer oder mehreren der LINECALLPARAMFLAGS_ Konstanten.
dwCallStates
Mindestens eine der LINECALLSTATE_ Konstanten, die die Zustände angibt, in denen die Anwendung bei diesem Aufruf benachrichtigt werden kann. Der dwCallStates-Member ist in LINECALLINFO konstant und ändert sich nicht je nach Anrufstatus.
dwMonitorDigitModes
Verschiedene Ziffernmodi. Dieser Member ist eine oder mehrere der LINEDIGITMODE_ Konstanten, für die derzeit die Überwachung aktiviert ist.
dwMonitorMediaModes
Verschiedene Medientypen, für die die Überwachung derzeit aktiviert ist. Dieser Member ist eine oder mehrere der LINEMEDIAMODE_ Konstanten.
DialParams
Wählparameter vom Typ LINEDIALPARAMS, die derzeit für den Aufruf wirksam sind. Sofern diese Parameter nicht von lineMakeCall oder lineSetCallParams festgelegt werden, entsprechen ihre Werte den Standardwerten, die in der LINEDEVCAPS-Struktur verwendet werden.
dwOrigin
Gibt an, woher der Aufruf stammt. Dieser Member kann eine der LINECALLORIGIN_ Konstanten sein.
dwReason
Grund, warum der Aufruf erfolgt ist. Dieser Member kann eine der LINECALLREASON_ Konstanten sein.
dwCompletionID
Vervollständigungsbezeichner für den eingehenden Aufruf, wenn er das Ergebnis einer Abschlussanforderung ist, die beendet wird. Dieser Bezeichner ist nur dann sinnvoll, wenn dwReason LINECALLREASON_CALLCOMPLETION ist.
dwNumOwners
Anzahl von Anwendungsmodulen mit unterschiedlichen Aufrufhandles mit Besitzerberechtigung für den Anruf.
dwNumMonitors
Anzahl von Anwendungsmodulen mit unterschiedlichen Aufrufhandles mit Überwachungsberechtigung für den Anruf.
dwCountryCode
Landes- oder Regionscode der Zielpartei. Null, wenn unbekannt.
dwTrunk
Nummer des Trunks, über den der Anruf weitergeleitet wird. Dieser Member wird sowohl für eingehende als auch für ausgehende Anrufe verwendet. Das dwTrunk-Element sollte auf 0xFFFFFFFF festgelegt werden, wenn es unbekannt ist.
dwCallerIDFlags
Bestimmt die Gültigkeit und den Inhalt der Aufrufer- oder Urheberinformationen des Parteibezeichners. Dieser Member verwendet eine der LINECALLPARTYID_ Konstanten.
dwCallerIDSize
Größe der Aufrufer-ID in Byte.
dwCallerIDOffset
Offset vom Anfang dieser Struktur zu dem Feld mit unterschiedlicher Größe, das die Idnnummer des Aufrufers enthält. Die Größe des Felds wird von dwCallerIDSize angegeben.
dwCallerIDNameSize
Größe des Aufrufer-ID-Namens einschließlich des NULL-Abschlusszeichens in Byte.
dwCallerIDNameOffset
Offset vom Anfang dieser Struktur zu dem Feld mit unterschiedlicher Größe, das die Namensinformationen der Aufruferpartei-ID enthält. Die Größe des Felds wird durch dwCallerIDNameSize angegeben.
dwCalledIDFlags
Bestimmt die Gültigkeit und den Inhalt der ID-Informationen der aufgerufenen Seite. Die aufgerufene Partei entspricht der ursprünglich adressierten Partei. Dieser Member verwendet eine der LINECALLPARTYID_ Konstanten.
dwCalledIDSize
Größe der Idnnummer der aufgerufenen Seite in Byte.
dwCalledIDOffset
Offset vom Anfang der Struktur zu dem feld mit variabeler Größe, das die Idnnummerinformationen der aufgerufenen Seite enthält. Die Größe des Felds wird von dwCalledIDSize angegeben.
dwCalledIDNameSize
Größe des Namens der aufgerufenen Id einschließlich des NULL-Abschlusszeichens in Byte.
dwCalledIDNameOffset
Offset vom Anfang der Struktur zum Feld mit variabeler Größe, das die Namensinformationen der aufgerufenen Partei-ID enthält. Die Größe des Felds wird durch dwCalledIDNameSize angegeben.
dwConnectedIDFlags
Bestimmt die Gültigkeit und den Inhalt der ID-Informationen der verbundenen Partei. Die verbundene Partei ist die Partei, mit der tatsächlich eine Verbindung hergestellt wurde. Dies kann sich von der ID des Aufgerufenen unterscheiden, wenn der Anruf umgeleitet wurde. Dieser Member verwendet eine der LINECALLPARTYID_ Konstanten.
dwConnectedIDSize
Größe der ID-Nummer der Verbundenen Partei in Byte.
dwConnectedIDOffset
Offset vom Anfang dieser Struktur zu dem feld mit variabeler Größe, das die Idnnummerinformationen der verbundenen Seite enthält. Die Größe des Felds wird durch dwConnectedIDSize angegeben.
dwConnectedIDNameSize
Größe des Namens der Verbindungspartei-ID einschließlich des NULL-Abschlusszeichens in Byte.
dwConnectedIDNameOffset
Offset vom Anfang dieser Struktur zu dem Feld mit unterschiedlicher Größe, das die Id-Informationen der verbundenen Seite enthält. Die Größe des Felds wird durch dwConnectedIDNameSize angegeben.
dwRedirectionIDFlags
Bestimmt die Gültigkeit und den Inhalt der Bezeichnerinformationen der Umleitungspartei. Die Umleitungspartei identifiziert die Adresse, an die die Sitzung umgeleitet wurde. Dieser Member verwendet eine der LINECALLPARTYID_ Konstanten.
dwRedirectionIDSize
Größe der Nummer der Umleitungspartei-ID in Byte.
dwRedirectionIDOffset
Offset vom Anfang der Struktur zum variabel dimensionierten Feld, das die Idnnummer der Umleitungspartei enthält. Die Größe des Felds wird durch dwRedirectionIDSize angegeben.
dwRedirectionIDNameSize
Größe des Namens der Umleitungspartei-ID in Bytes.
dwRedirectionIDNameOffset
Offset vom Anfang der Struktur auf das variabel dimensionierte Feld, das die Informationen zur Umleitungspartei-ID enthält. Die Größe des Felds wird durch dwRedirectionIDNameSize angegeben.
dwRedirectingIDFlags
Bestimmt die Gültigkeit und den Inhalt der Informationen zum Umleitenden Parteibezeichner. Die umleitende Partei identifiziert die Adresse, die die Sitzung umleitet. Dieser Member verwendet eine der LINECALLPARTYID_ Konstanten.
dwRedirectingIDSize
Größe der Nummer der Umleitungspartei-ID in Byte.
dwRedirectingIDOffset
Offset vom Anfang der -Struktur zum variabel dimensionierten Feld, das die Idnnummer der Umleitungspartei enthält. Die Größe des Felds wird durch dwRedirectingIDSize angegeben.
dwRedirectingIDNameSize
Größe des Namens der Umleitungspartei-ID einschließlich des NULL-Abschlusszeichens in Bytes.
dwRedirectingIDNameOffset
Offset vom Anfang der -Struktur auf das feld mit variabeler Größe, das die Id-Namensinformationen der Umleitungspartei enthält. Die Größe des Felds wird durch dwRedirectingIDNameSize angegeben.
dwAppNameSize
Größe des Anwendungsnamenfelds einschließlich des NULL-Abschlusszeichens in Bytes.
dwAppNameOffset
Offset vom Anfang der -Struktur zu dem feld mit unterschiedlicher Größe, das den benutzerfreundlichen Namen der Anwendung enthält, die den Anruf zuerst gestartet, angenommen oder angenommen hat. Dies ist der Name, den eine Anwendung in lineInitializeEx angeben kann. Wenn die Anwendung keinen solchen Namen angibt, wird stattdessen der Moduldateiname der Anwendung verwendet. Die Größe des Felds wird von dwAppNameSize angegeben.
dwDisplayableAddressSize
Größe der anzeigebaren Adresszeichenfolge einschließlich des NULL-Abschlusszeichens in Bytes.
dwDisplayableAddressOffset
Die anzeigebare Zeichenfolge wird zu Protokollierungszwecken verwendet. Die Informationen werden von LINECALLPARAMS für Funktionen abgerufen, die Aufrufe initiieren. Die lineTranslateAddress-Funktion gibt die entsprechenden Informationen zurück, die in diesem Feld in den Elementen dwDisplayableAddressSize und dwDisplayableAddressOffset der LINETRANSLATEOUTPUT-Struktur platziert werden sollen.
dwCalledPartySize
Größe des Beschreibungsfelds der aufgerufenen Seite in Byte.
dwCalledPartyOffset
Offset vom Anfang der -Struktur bis zum Feld mit variabeler Größe, das die benutzerfreundliche Beschreibung der aufgerufenen Partei angibt. Diese Informationen können mit lineMakeCall angegeben und optional im lpCallParams-Parameter angegeben werden, wenn ein neuer Aufruf eingerichtet wird. Es ist für Anrufprotokollierungszwecke nützlich. Die Größe des Felds wird von dwCalledPartySize angegeben.
dwCommentSize
Größe des Kommentarfelds in Bytes.
dwCommentOffset
Offset vom Anfang der Struktur zu dem Feld mit variabeler Größe, das einen Kommentar zum Aufruf enthält, der von der Anwendung bereitgestellt wurde, die den Aufruf mit lineMakeCall ausgelöst hat. Diese Informationen können optional im lpCallParams-Parameter angegeben werden, wenn ein neuer Aufruf eingerichtet wird. Die Größe des Felds wird von dwCommentSize angegeben.
dwDisplaySize
Größe der rohen Anzeigeinformationen in Byte.
dwDisplayOffset
Offset vom Anfang der Struktur bis zum variabel dimensionierten Feld, das rohe Anzeigeinformationen enthält. Abhängig von der Telefonieumgebung kann ein Dienstanbieter funktionsbezogene Informationen aus diesem Memberpaar extrahieren, um diese Für diese Telefoniekonfiguration am besten geeignet zu formatieren und zu präsentieren. Die Größe des Felds wird von dwDisplaySize angegeben.
dwUserUserInfoSize
Größe der Benutzer-/Benutzerinformationen in Bytes. Wenn die Benutzer-Benutzer-Informationen ein Zeiger auf eine Zeichenfolge sind, muss die Größe den NULL-Abschlusszeichen enthalten.
dwUserUserInfoOffset
Offset vom Anfang der Struktur bis zum variabel dimensionierten Feld mit Benutzer-Benutzer-Informationen. Das Protokolldiskriminatorfeld für die Benutzer-Benutzer-Informationen wird bei Verwendung als erstes Byte der Daten angezeigt, auf die dwUserUserInfoOffset verweist, und wird in dwUserUserInfoSize berücksichtigt.
dwHighLevelCompSize
Größe der allgemeinen Kompatibilitätsinformationen in Bytes.
dwHighLevelCompOffset
Offset vom Anfang der Struktur bis zum variabel dimensionierten Feld, das allgemeine Kompatibilitätsinformationen enthält. Das Format dieser Informationen wird durch andere Standards (ISDN Q.931) festgelegt. Die Größe des Felds wird von dwHighLevelCompSize angegeben.
dwLowLevelCompSize
Größe der Kompatibilitätsinformationen auf niedriger Ebene in Byte.
dwLowLevelCompOffset
Offset vom Anfang der Struktur bis zum variabel dimensionierten Feld, das Kompatibilitätsinformationen auf niedriger Ebene enthält. Das Format dieser Informationen wird durch andere Standards (ISDN Q.931) festgelegt. Die Größe des Felds wird von dwLowLevelCompSize angegeben.
dwChargingInfoSize
Größe der Ladeinformationen in Byte.
dwChargingInfoOffset
Offset vom Anfang der Struktur zum variabel dimensionierten Feld, das Ladeinformationen enthält. Das Format dieser Informationen wird durch andere Standards (ISDN Q.931) festgelegt. Die Größe des Felds wird durch dwChargingInfoSize angegeben.
dwTerminalModesSize
Größe des aktuellen Arrays der Terminalmodi in Byte.
dwTerminalModesOffset
Offset vom Anfang der -Struktur zum variabel dimensionierten Gerätefeld, das ein Array mit Einträgen im DWORD-Format enthält. Arrayeinträge werden nach Terminalbezeichnern im Bereich von null bis eins kleiner als dwNumTerminals indiziert. Jeder Eintrag im Array gibt die aktuellen Terminalmodi für den entsprechenden Terminalsatz mit der lineSetTerminal-Funktion für den Mediendatenstrom dieses Aufrufs an, wie durch eine der LINETERMMODE_ Konstanten angegeben. Die Größe des Arrays wird von dwTerminalModesSize angegeben.
dwDevSpecificSize
Größe des gerätespezifischen Felds in Bytes.
dwDevSpecificOffset
Offset vom Anfang der Struktur zum variabel dimensionierten Feld, das gerätespezifische Informationen enthält. Die Größe des Felds wird von dwDevSpecificSize angegeben.
dwCallTreatment
Anrufbehandlung, die derzeit auf den Anruf angewendet wird oder angewendet wird, wenn der Anruf in den nächsten anwendbaren Zustand wechselt. Kann null sein, wenn Anrufbehandlungen nicht unterstützt werden.
dwCallDataSize
Größe der von der Anwendung festgelegten Aufrufdaten in Bytes.
dwCallDataOffset
Offset vom Anfang der Struktur bis zu den für die Anwendung festgelegten Aufrufdaten. Die Größe des Felds wird von dwCallDataSize angegeben.
dwSendingFlowspecSize
Größe der Dienstqualitätsinformationen in Bytes.
dwSendingFlowspecOffset
Offset vom Anfang der Struktur zu einer FLOWSPEC-Struktur gefolgt von WinSock-anbieterspezifischen Daten, die in SendingFlowspec in einer QOS-Struktur gespeichert worden wären. Gibt die Dienstqualität an, die derzeit in der Senderichtung des Anrufs wirksam ist. Der anbieterspezifische Teil, der der FLOWSPEC-Struktur folgt, darf keine Zeiger auf andere Speicherblöcke enthalten, da TAPI nicht weiß, wie die Daten gemarshallt werden sollen, auf die die privaten Zeiger verweisen, und sie über die prozessübergreifende Kommunikation mit der Anwendung übertragen werden. Die Größe des Felds wird durch dwSendingFlowspecSize angegeben.
dwReceivingFlowspecSize
Größe der Dienstqualitätsinformationen in Bytes.
dwReceivingFlowspecOffset
Offset vom Anfang der -Struktur zu einer FLOWSPEC-Struktur gefolgt von WinSock-anbieterspezifischen Daten, was in ReceiveingFlowspec in einer QOS-Struktur gespeichert worden wäre. Gibt die Dienstqualität an, die aktuell in der Empfangsrichtung des Aufrufs wirksam ist. Der anbieterspezifische Teil, der der FLOWSPEC-Struktur folgt, darf keine Zeiger auf andere Speicherblöcke enthalten, da TAPI nicht weiß, wie die Daten gemarshallt werden sollen, auf die die privaten Zeiger verweisen, und sie über die prozessübergreifende Kommunikation mit der Anwendung übertragen werden. Die Größe des Felds wird durch dwReceivingFlowspecSize angegeben.
dwCallerIDAddressType
Adresstyp des Aufrufers. Dieses Element der -Struktur ist nur verfügbar, wenn die ausgehandelte TAPI-Version 3.0 oder höher ist.
dwCalledIDAddressType
Adresstyp der aufgerufenen Partei. Dieses Element der -Struktur ist nur verfügbar, wenn die ausgehandelte TAPI-Version 3.0 oder höher ist.
dwConnectedIDAddressType
Adresstyp des Ziels, mit dem der Anruf tatsächlich verbunden war. Dieses Element der -Struktur ist nur verfügbar, wenn die ausgehandelte TAPI-Version 3.0 oder höher ist.
dwRedirectionIDAddressType
Adresstyp des neuen Anrufziels. Dieses Element der -Struktur ist nur verfügbar, wenn die ausgehandelte TAPI-Version 3.0 oder höher ist.
dwRedirectingIDAddressType
Adresstyp des Standorts, der den Anruf umgeleitet hat. Dieses Element der -Struktur ist nur verfügbar, wenn die ausgehandelte TAPI-Version 3.0 oder höher ist.
Hinweise
Gerätespezifische Erweiterungen sollten den DevSpecific-Bereich (dwDevSpecificSize und dwDevSpecificOffset) mit unterschiedlicher Größe dieser Datenstruktur verwenden.
Die LINECALLINFO-Datenstruktur enthält relativ feste Informationen zu einem Aufruf. Diese Struktur wird mit lineGetCallInfo zurückgegeben. Wenn sich Informationselemente in dieser Datenstruktur geändert haben, wird eine LINE_CALLINFO-Nachricht an die Anwendung gesendet. Ein Parameter für diese Meldung ist das Informationselement oder Feld, das sich geändert hat.
Die Member dwCallTreatment bis dwReceivingFlowspecOffset sind nur für Anwendungen verfügbar, die das Leitungsgerät mit einer API-Version von 2.0 oder höher öffnen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | tapi.h |