LINEADDRESSCAPS-Struktur (tapi.h)

Artikel
08/26/2023

Die LINEADDRESSCAPS-Struktur beschreibt die Funktionen einer angegebenen Adresse. Die lineGetAddressCaps-Funktion und die TSPI_lineGetAddressCaps-Funktion geben die LINEADDRESSCAPS-Struktur zurück.

Syntax

typedef struct lineaddresscaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwLineDeviceID;
  DWORD dwAddressSize;
  DWORD dwAddressOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAddressSharing;
  DWORD dwAddressStates;
  DWORD dwCallInfoStates;
  DWORD dwCallerIDFlags;
  DWORD dwCalledIDFlags;
  DWORD dwConnectedIDFlags;
  DWORD dwRedirectionIDFlags;
  DWORD dwRedirectingIDFlags;
  DWORD dwCallStates;
  DWORD dwDialToneModes;
  DWORD dwBusyModes;
  DWORD dwSpecialInfo;
  DWORD dwDisconnectModes;
  DWORD dwMaxNumActiveCalls;
  DWORD dwMaxNumOnHoldCalls;
  DWORD dwMaxNumOnHoldPendingCalls;
  DWORD dwMaxNumConference;
  DWORD dwMaxNumTransConf;
  DWORD dwAddrCapFlags;
  DWORD dwCallFeatures;
  DWORD dwRemoveFromConfCaps;
  DWORD dwRemoveFromConfState;
  DWORD dwTransferModes;
  DWORD dwParkModes;
  DWORD dwForwardModes;
  DWORD dwMaxForwardEntries;
  DWORD dwMaxSpecificEntries;
  DWORD dwMinFwdNumRings;
  DWORD dwMaxFwdNumRings;
  DWORD dwMaxCallCompletions;
  DWORD dwCallCompletionConds;
  DWORD dwCallCompletionModes;
  DWORD dwNumCompletionMessages;
  DWORD dwCompletionMsgTextEntrySize;
  DWORD dwCompletionMsgTextSize;
  DWORD dwCompletionMsgTextOffset;
  DWORD dwAddressFeatures;
  DWORD dwPredictiveAutoTransferStates;
  DWORD dwNumCallTreatments;
  DWORD dwCallTreatmentListSize;
  DWORD dwCallTreatmentListOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwMaxCallDataSize;
  DWORD dwCallFeatures2;
  DWORD dwMaxNoAnswerTimeout;
  DWORD dwConnectedModes;
  DWORD dwOfferingModes;
  DWORD dwAvailableMediaModes;
} LINEADDRESSCAPS, *LPLINEADDRESSCAPS;

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.

dwLineDeviceID

Geräte-ID des Leitungsgeräts, dem diese Adresse zugeordnet ist.

dwAddressSize

Größe des Adressfelds in Bytes.

dwAddressOffset

Offset vom Anfang der Struktur zum variabel dimensionierten Adressfeld. Die Größe des Felds wird von dwAddressSize angegeben.

dwDevSpecificSize

Größe des gerätespezifischen Felds in Bytes.

dwDevSpecificOffset

Offset vom Anfang der Struktur zum variabel dimensionierten gerätespezifischen Feld. Die Größe des Felds wird von dwDevSpecificSize angegeben.

dwAddressSharing

Freigabemodus der Adresse. Dieser Member kann eine der LINEADDRESSSHARING_ Konstanten sein.

dwAddressStates

Adressstatusänderungen, über die die Anwendung möglicherweise in der LINE_ADDRESSSTATE-Nachricht benachrichtigt wird. Dieser Member verwendet eine oder mehrere der LINEADDRESSSTATE_ Konstanten.

dwCallInfoStates

Rufen Sie Informationselemente auf, die für alle Aufrufe dieser Adresse sinnvoll sind. Eine Anwendung wird möglicherweise über Änderungen in einigen dieser Zustände in LINE_CALLINFO Meldungen benachrichtigt. Dieser Member verwendet eine oder mehrere der LINECALLINFOSTATE_ Konstanten.

dwCallerIDFlags

Typen von Parteibezeichnerinformationen, die für Aufrufe mit dieser Adresse bereitgestellt werden können. Der Aufrufer ist der Urheber der Sitzung. Mindestens eine der LINECALLPARTYID_ Konstanten.

dwCalledIDFlags

Typen von Parteibezeichnerinformationen, die für Aufrufe mit dieser Adresse bereitgestellt werden können. Hier bezieht sich "aufgerufen" auf das ursprüngliche Ziel. Mindestens eine der LINECALLPARTYID_ Konstanten.

dwConnectedIDFlags

Typen von Parteibezeichnerinformationen, die für Aufrufe mit dieser Adresse bereitgestellt werden können. Mindestens eine der LINECALLPARTYID_ Konstanten.

dwRedirectionIDFlags

Typen von Parteibezeichnerinformationen, die für Aufrufe mit dieser Adresse bereitgestellt werden können. Hier ist "Umleitung" das neue Ziel. Mindestens eine der LINECALLPARTYID_ Konstanten.

dwRedirectingIDFlags

Typen von Parteibezeichnerinformationen, die für Aufrufe mit dieser Adresse bereitgestellt werden können. Hier ist "Umleitung" die Adresse, die die Umleitung aufgerufen hat. Mindestens eine der LINECALLPARTYID_ Konstanten.

dwCallStates

Anrufzustände, die für Anrufe über diese Adresse gemeldet werden können. Dieser Member verwendet eine oder mehrere der LINECALLSTATE_ Konstanten.

dwDialToneModes

Wählmodi, die für Anrufe gemeldet werden können, die über diese Adresse getätigt werden. Dieser Member ist nur dann sinnvoll, wenn der Anrufstatus des Wähltons gemeldet werden kann. Dieser Member verwendet eine oder mehrere der LINEDIALTONEMODE_ Konstanten.

dwBusyModes

Ausgelastete Modi, die für Anrufe gemeldet werden können, die über diese Adresse ausgeführt werden. Dieser Member ist nur sinnvoll, wenn der Status des ausgelasteten Anrufs gemeldet werden kann. Dieser Member verwendet eine oder mehrere der LINEBUSYMODE_ Konstanten.

dwSpecialInfo

Spezielle Informationstypen, die für Anrufe über diese Adresse gemeldet werden können. Dieser Member ist nur dann sinnvoll, wenn der SpecialInfo-Aufrufstatus gemeldet werden kann. Dieser Member verwendet eine oder mehrere der LINESPECIALINFO_ Konstanten.

dwDisconnectModes

Verbindungsmodi, die für Anrufe gemeldet werden können, die über diese Adresse ausgeführt werden. Dieser Member ist nur dann sinnvoll, wenn der Status des getrennten Aufrufs gemeldet werden kann. Dieser Member verwendet eine oder mehrere der LINEDISCONNECTMODE_ Konstanten.

dwMaxNumActiveCalls

Maximale Anzahl von aktiven Aufrufdarstellungen, die von der Adresse verarbeitet werden können. Diese Nummer umfasst keine Anrufe im Halte- oder Warteschleifen von Übertragungen oder Konferenzen.

dwMaxNumOnHoldCalls

Maximale Anzahl von Anrufdarstellungen an der Adresse, die sich im Haltebereich halten können.

dwMaxNumOnHoldPendingCalls

Maximale Anzahl von Anrufdarstellungen an der Adresse, die sich in der Warteschleife der Übertragung oder Konferenz bewähren kann.

dwMaxNumConference

Maximale Anzahl von Parteien, die an einer einzelnen Telefonkonferenz über diese Adresse teilnehmen können.

dwMaxNumTransConf

Anzahl von Parteien (einschließlich "selbst"), die in einer Telefonkonferenz hinzugefügt werden können, die als generische Konsultation mit lineSetupTransfer initiiert wird.

dwAddrCapFlags

Gepackte Bitflags, die eine Vielzahl von Adressfunktionen beschreiben. Dieser Member verwendet eine oder mehrere der LINEADDRCAPFLAGS_ Konstanten.

dwCallFeatures

Wechseln von Funktionen oder Features, die für alle Aufrufe dieser Adresse verfügbar sind, mithilfe der LINECALLFEATURE_ Konstanten. Dieser Member stellt die anrufbezogenen Features dar, die möglicherweise für eine Adresse verfügbar sind (statische Verfügbarkeit im Gegensatz zur dynamischen Verfügbarkeit). Um ein unterstütztes Feature aufzurufen, muss sich der Aufruf im richtigen Zustand befinden und das zugrunde liegende Leitungsgerät in einem kompatiblen Modus geöffnet werden. Eine Null in einer Bitposition gibt an, dass das entsprechende Feature nie verfügbar ist. Eine gibt an, dass das entsprechende Feature möglicherweise verfügbar ist, wenn die Anwendung über die richtigen Berechtigungen für den Aufruf verfügt und sich der Aufruf im geeigneten Zustand befindet, damit der Vorgang sinnvoll ist. Mit diesem Member kann eine Anwendung ermitteln, welche Aufruffunktionen von der Adresse unterstützt werden können (und welche niemals unterstützt werden können).

dwRemoveFromConfCaps

Die Funktionen von Address zum Entfernen von Anrufen aus einer Telefonkonferenz. Dieser Member verwendet eine der LINEREMOVEFROMCONF_ Konstanten.

dwRemoveFromConfState

Verwendet die LINECALLSTATE_ Konstanten, um den Status des Anrufs anzugeben, nachdem er aus einer Telefonkonferenz entfernt wurde.

dwTransferModes

Adressfunktionen zum Auflösen von Übertragungsanforderungen. Dieser Member verwendet eine der LINETRANSFERMODE_ Konstanten.

dwParkModes

Unter dieser Adresse stehen verschiedene Anrufparkmodi zur Verfügung. Dieser Member verwendet eine der LINEPARKMODE_ Konstanten.

dwForwardModes

Für diese Adresse stehen verschiedene Weiterleitungsmodi zur Verfügung. Dieser Member verwendet die LINEFORWARDMODE_ Konstanten.

dwMaxForwardEntries

Maximale Anzahl von Einträgen, die im lpForwardList-Parameter an lineForward übergeben werden können.

dwMaxSpecificEntries

Maximale Anzahl von Einträgen im lpForwardList-Parameter , der an lineForward übergeben wird und Weiterleitungsanweisungen basierend auf einer bestimmten Aufrufer-ID enthalten kann (selektive Anrufweiterleitung). Dieser Member ist null, wenn die selektive Anrufweiterleitung nicht unterstützt wird.

dwMinFwdNumRings

Mindestanzahl von Ringen, die festgelegt werden können, um zu bestimmen, wann ein Anruf offiziell als "keine Antwort" betrachtet wird.

dwMaxFwdNumRings

Maximale Anzahl von Ringen, die festgelegt werden können, um zu bestimmen, wann ein Anruf offiziell als "keine Antwort" betrachtet wird. Wenn diese Anzahl von Ringen nicht festgelegt werden kann, sind dwMinFwdNumRings und dwMaxNumRings gleich.

dwMaxCallCompletions

Maximale Anzahl gleichzeitiger Aufrufabschlussanforderungen, die auf diesem Leitungsgerät ausstehen können. Null bedeutet, dass der Aufrufabschluss nicht verfügbar ist.

dwCallCompletionConds

Verschiedene Anrufbedingungen, unter denen der Abschluss des Anrufs angefordert werden kann. Dieser Member verwendet eine oder mehrere der LINECALLCOMPLCOND_ Konstanten.

dwCallCompletionModes

Art und Weise, wie der Anruf abgeschlossen werden kann. Dieser Member verwendet eine der LINECALLCOMPLMODE_ Konstanten.

dwNumCompletionMessages

Anzahl der Anrufabschlussnachrichten, die bei Verwendung der Option LINECALLCOMPLMODE_MESSAGE ausgewählt werden können. Einzelne Nachrichten werden durch Werte im Bereich null bis 1 kleiner als dwNumCompletionMessages identifiziert.

dwCompletionMsgTextEntrySize

Größe der einzelnen Textbeschreibungen für die Aufrufvervollständigung, die in dwCompletionMsgTextSize und dwCompletionMsgTextOffset angegeben sind, in Byte.

dwCompletionMsgTextSize

Größe des Aufrufabschlusstexts in Bytes.

dwCompletionMsgTextOffset

Offset vom Anfang dieser Datenstruktur zu dem Feld mit unterschiedlicher Größe, das beschreibenden Text zu den einzelnen Aufrufabschlussmeldungen enthält. Jede Nachricht ist dwCompletionMsgTextEntrySize bytes long. Das Zeichenfolgenformat dieser Textbeschreibungen wird durch dwStringFormat in den Gerätefunktionen der Zeile angegeben. Die Größe des Felds wird von dwCompletionMsgTextSize angegeben.

dwAddressFeatures

Für diese Adresse verfügbare Features mit den LINEADDRFEATURE_ Konstanten. Um ein unterstütztes Feature aufzurufen, muss sich die Adresse im richtigen Zustand befinden und das zugrunde liegende Leitungsgerät in einem kompatiblen Modus geöffnet werden. Eine Null in einer Bitposition gibt an, dass das entsprechende Feature nie verfügbar ist. Eine gibt an, dass das entsprechende Feature möglicherweise verfügbar ist, wenn sich die Adresse im geeigneten Zustand befindet, damit der Vorgang sinnvoll ist. Mit diesem Member kann eine Anwendung ermitteln, welche Adressfeatures von der Adresse unterstützt werden können (und welche niemals unterstützt werden können).

dwPredictiveAutoTransferStates

Anrufstatus oder Zustände, in denen ein Von einem Prädiktiver getätigter Anruf so eingestellt werden kann, dass der Anruf automatisch an eine andere Adresse übertragen wird; eine oder mehrere der LINECALLSTATE_ Konstanten. Der Wert 0 gibt an, dass die automatische Übertragung basierend auf dem Anrufzustand nicht verfügbar ist.

dwNumCallTreatments

Anzahl der Einträge im Array der LINECALLTREATMENTENTRY-Strukturen , die durch dwCallTreatmentListSize und dwCallTreatmentListOffset getrennt sind.

dwCallTreatmentListSize

Größe des Aufrufbehandlungsarrays in Bytes.

dwCallTreatmentListOffset

Offset vom Anfang der -Struktur zu einem Array von LINECALLTREATMENTENTRY-Strukturen , die die für die Adresse unterstützten Anrufbehandlungen angeben (die mithilfe von lineSetCallTreatment ausgewählt werden können). Der Wert ist dwNumCallTreatments mal SIZEOF(LINECALLTREATMENTENTRY). Die Größe des Felds wird durch dwCallTreatmentListSize angegeben.

dwDeviceClassesSize

Größe der Liste der unterstützten Geräteklassen in Bytes.

dwDeviceClassesOffset

Offset vom Anfang der Struktur zu einer Zeichenfolge, die aus den Geräteklassenbezeichnern besteht, die für diese Adresse zur Verwendung mit lineGetID unterstützt werden. Die Elemente werden durch NULL-Zeichen getrennt, und auf den letzten Klassenbezeichner folgen zwei NULL-Zeichen . Die Größe des Felds wird von dwDeviceClassesSize angegeben.

dwMaxCallDataSize

Maximale Anzahl von Bytes, die eine Anwendung in LINECALLINFO mithilfe von lineSetCallData festlegen kann.

dwCallFeatures2

Zusätzliche Switching-Funktionen oder -Features, die für alle Aufrufe dieser Adresse mithilfe der LINECALLFEATURE2_Konstanten verfügbar sind. Es handelt sich um eine Erweiterung des dwCallFeatures-Elements .

dwMaxNoAnswerTimeout

Maximaler Wert in Sekunden, der im dwNoAnswerTimeout-Member in LINECALLPARAMS festgelegt werden kann, wenn ein Anruf erfolgt. Der Wert 0 gibt an, dass das automatische Abbrechen nicht beantworteter Aufrufe vom Dienstanbieter nicht unterstützt wird oder dass der Timeoutwert von Anwendungen nicht angepasst werden kann.

dwConnectedModes

LINECONNECTEDMODE_ Werte, die im dwCallStateMode-Member von LINECALLSTATUS und in LINE_CALLSTATE Nachrichten für Anrufe für diese Adresse angezeigt werden können.

dwOfferingModes

LINEOFFERINGMODE_ Werte, die im dwCallStateMode-Member von LINECALLSTATUS und in LINE_CALLSTATE Nachrichten für Aufrufe für diese Adresse angezeigt werden können.

dwAvailableMediaModes

Medientypen (Modi), die für neue Aufrufe aufgerufen werden können, die für diese Adresse erstellt wurden, wenn das dwAddressFeatures-Element angibt, dass neue Aufrufe möglich sind. Wenn dieser Member null ist, gibt dies an, dass der Dienstanbieter entweder nicht weiß oder nicht angeben kann, welche Medientypen verfügbar sind. In diesem Fall sind möglicherweise alle im dwMediaModes-Element in LINEDEVCAPS angegebenen Medientypen verfügbar.

Hinweise

Gerätespezifische Erweiterungen sollten den DevSpecific-Bereich (dwDevSpecificSize und dwDevSpecificOffset) mit unterschiedlicher Größe dieser Datenstruktur verwenden.

Ältere Anwendungen werden ohne dieses Element in der LINEADDRESSCAPS-Struktur kompiliert und verwenden einen SIZEOF(LINEADDRESSCAPS), der kleiner als die neue Größe ist. Die Anwendung übergibt einen dwAPIVersion-Parameter mit der lineGetAddressCaps-Funktion , die von TAPI bei der Behandlung dieser Situation als Anleitung verwendet werden kann. Wenn die Anwendung einen dwTotalSize-Member übergibt, der kleiner als die Größe des festen Teils der Struktur ist, wie im angegebenen dwAPIVersion-Member definiert, wird LINEERR_STRUCTURETOOSMALL zurückgegeben. Wenn von der Anwendung ausreichend Arbeitsspeicher zugewiesen wurde, legt TAPI vor dem Aufruf von TSPI_lineGetAddressCaps die Elemente dwNeededSize und dwUsedSize auf die feste Größe der Struktur fest, wie sie in der angegebenen API-Version vorhanden war.

Neue Dienstanbieter (die die neue API-Version unterstützen) müssen die übergebene API-Version überprüfen. Wenn die API-Version kleiner als die höchste vom Anbieter unterstützte Version ist, darf der Dienstanbieter keine Felder ausfüllen, die in älteren API-Versionen nicht unterstützt werden, da diese in den variablen Teil der älteren Struktur fallen würden.

Neue Anwendungen müssen die ausgehandelte API-Version kennen und dürfen den Inhalt von Feldern im festen Teil nicht über das ursprüngliche Ende des festen Teils der Struktur für die ausgehandelte API-Version hinaus untersuchen.

Die Member dwPredictiveAutoTransferStates bis dwAvailableMediaModes sind nur für Anwendungen verfügbar, die beim Aufrufen von lineGetAddressCaps eine API-Version von 2.0 oder höher anfordern.