Freigeben über


LINECALLPARAMS-Struktur (tapi.h)

Die LINECALLPARAMS-Struktur beschreibt parameter, die beim Ausführen von Aufrufen mit den Funktionen lineMakeCall und TSPI_lineMakeCall bereitgestellt werden. Die LINECALLPARAMS-Struktur wird auch als Parameter in anderen Vorgängen wie der lineOpen-Funktion verwendet.

Die Kommentare rechts neben dem Syntaxblock geben die Standardwerte an, die verwendet werden, wenn diese Struktur nicht für lineMakeCall bereitgestellt wird.

Syntax

typedef struct linecallparams_tag {
  DWORD          dwTotalSize;
  DWORD          dwBearerMode;
  DWORD          dwMinRate;
  DWORD          dwMaxRate;
  DWORD          dwMediaMode;
  DWORD          dwCallParamFlags;
  DWORD          dwAddressMode;
  DWORD          dwAddressID;
  LINEDIALPARAMS DialParams;
  DWORD          dwOrigAddressSize;
  DWORD          dwOrigAddressOffset;
  DWORD          dwDisplayableAddressSize;
  DWORD          dwDisplayableAddressOffset;
  DWORD          dwCalledPartySize;
  DWORD          dwCalledPartyOffset;
  DWORD          dwCommentSize;
  DWORD          dwCommentOffset;
  DWORD          dwUserUserInfoSize;
  DWORD          dwUserUserInfoOffset;
  DWORD          dwHighLevelCompSize;
  DWORD          dwHighLevelCompOffset;
  DWORD          dwLowLevelCompSize;
  DWORD          dwLowLevelCompOffset;
  DWORD          dwDevSpecificSize;
  DWORD          dwDevSpecificOffset;
  DWORD          dwPredictiveAutoTransferStates;
  DWORD          dwTargetAddressSize;
  DWORD          dwTargetAddressOffset;
  DWORD          dwSendingFlowspecSize;
  DWORD          dwSendingFlowspecOffset;
  DWORD          dwReceivingFlowspecSize;
  DWORD          dwReceivingFlowspecOffset;
  DWORD          dwDeviceClassSize;
  DWORD          dwDeviceClassOffset;
  DWORD          dwDeviceConfigSize;
  DWORD          dwDeviceConfigOffset;
  DWORD          dwCallDataSize;
  DWORD          dwCallDataOffset;
  DWORD          dwNoAnswerTimeout;
  DWORD          dwCallingPartyIDSize;
  DWORD          dwCallingPartyIDOffset;
  DWORD          dwAddressType;
} LINECALLPARAMS, *LPLINECALLPARAMS;

Member

dwTotalSize

Dieser Datenstruktur zugeordnete Gesamtgröße in Byte. Diese Größe sollte groß genug sein, um alle festen und variabel dimensionierten Teile dieser Datenstruktur zu enthalten.

dwBearerMode

Bearermodus für den Anruf. Dieser Member verwendet eine der LINEBEARERMODE_ Konstanten.

Wenn dwBearerMode null ist, ist der Standardwert LINEBEARERMODE_VOICE.

dwMinRate

Die für den Datenstrom des Aufrufs angeforderte Mindestdatenrate in Bps (Bits pro Sekunde).

dwMaxRate

Maximale Datenrate, die für den Datenstrom des Aufrufs in Bps (Bits pro Sekunde) angefordert wird. Beim Tätigen eines Anrufs versucht der Dienstanbieter, die höchste verfügbare Rate im angeforderten Bereich (dwMinRate bis dwMaxRate) bereitzustellen. Wenn eine bestimmte Datenrate erforderlich ist, sollten sowohl dwMinRate als auch dwMaxRate auf diesen Wert festgelegt werden. Wenn eine Anwendung am besten mit einer Rate funktioniert, aber zu niedrigeren Raten herabstufen kann, sollte die Anwendung diese als Maximal- bzw. Mindestsätze angeben. Wenn dwMaxRate null ist, wird der Standardwert gemäß dem dwMaxRate-Element der LINEDEVCAPS-Struktur angegeben. Dies ist die maximale Rate, die vom Gerät unterstützt wird.

dwMediaMode

Erwarteter Medientyp des Aufrufs. Dieser Member verwendet eine der LINEMEDIAMODE_ Konstanten.

Wenn dwMediaMode null ist, ist der Standardwert LINEMEDIAMODE_INTERACTIVEVOICE.

dwCallParamFlags

Sammlung von booleschen Aufrufsetupparametern. Dieser Member verwendet eine oder mehrere der LINECALLPARAMFLAGS_ Konstanten.

dwAddressMode

Modus, in dem die Ursprungsadresse angegeben wird. Dieser Member verwendet eine der LINEADDRESSMODE_ Konstanten.

Hinweis Der dwAddressMode-Member kann nicht für den LineOpen-Funktionsaufruf LINEADDRESSMODE_ADDRESSID werden. Diese Einschränkung gilt jedoch nicht für lineMakeCall.
 

dwAddressID

Der Adressbezeichner der Ursprungsadresse, wenn dwAddressMode auf LINEADDRESSMODE_ADDRESSID festgelegt ist. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

DialParams

Für diesen Aufruf zu verwendende Wählparameter vom Typ LINEDIALPARAMS. Wenn für dieses Feld der Wert 0 angegeben wird, wird der Standardwert für das Feld verwendet, wie im DefaultDialParams-Element der LINEDEVCAPS-Struktur angegeben. Wenn ein Wert ungleich null für ein Feld angegeben wird, das sich außerhalb des durch die entsprechenden Felder in MinDialParams und MaxDialParams in der LINEDEVCAPS-Struktur angegebenen Bereichs befindet, wird stattdessen der nächste Wert innerhalb des gültigen Bereichs verwendet.

dwOrigAddressSize

Größe des ursprünglichen Adressfelds in Byte.

dwOrigAddressOffset

Offset vom Anfang der -Struktur zum variabel dimensionierten Feld, das die Ursprungsadresse enthält. Das Format dieser Adresse ist vom dwAddressMode-Element abhängig. Die Größe des Felds wird von dwOrigAddressSize angegeben.

dwDisplayableAddressSize

Größe der angezeigten Zeichenfolge einschließlich des NULL-Abschlusszeichens in Bytes.

dwDisplayableAddressOffset

Anzeigebare Zeichenfolge, die zu Protokollierungszwecken verwendet wird. Der Inhalt dieser Member wird in den Elementen dwDisplayableAddressOffset und dwDisplayableAddressSize der LINECALLINFO-Nachricht des Aufrufs aufgezeichnet. 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. Die Größe des Felds wird durch dwDisplayableAddressSize angegeben.

dwCalledPartySize

Größe der Informationen der aufgerufenen Seite in Byte.

dwCalledPartyOffset

Offset vom Anfang der Struktur bis zum variabel dimensionierten Feld, das die Informationen der aufgerufenen Seite enthält. Diese Informationen können von der Anwendung angegeben werden, die den Aufruf vornimmt und zu Protokollierungszwecken in der Informationsstruktur des Aufrufs zur Verfügung gestellt wird. Das Format dieses Felds ist das format dwStringFormat, wie in LINEDEVCAPS angegeben. Die Größe des Felds wird von dwCalledPartySize angegeben.

dwCommentSize

Größe des Aufrufkommentarfelds in Bytes.

dwCommentOffset

Offset vom Anfang der -Struktur zum variabel dimensionierten Feld mit Kommentaren zum Aufruf. Diese Informationen können von der Anwendung angegeben werden, die den Aufruf vornimmt und zu Protokollierungszwecken in der Informationsstruktur des Aufrufs zur Verfügung gestellt wird. Das Format dieses Felds ist das format dwStringFormat, wie in LINEDEVCAPS angegeben. Die Größe des Felds wird von dwCommentSize angegeben.

dwUserUserInfoSize

Größe der Benutzer-/Benutzerinformationen einschließlich des NULL-Abschlusszeichens in Bytes.

dwUserUserInfoOffset

Offset vom Anfang der Struktur bis zum variabel dimensionierten Feld mit Benutzer-Benutzer-Informationen. Das Protokoll-Diskriminatorfeld für die Benutzer-Benutzer-Informationen sollte bei Bedarf als erstes Byte der Daten angezeigt werden, auf die dwUserUserInfoOffset verweist, und muss in dwUserUserInfoSize berücksichtigt werden.

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. 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. Die Größe des Felds wird von dwLowLevelCompSize angegeben.

dwDevSpecificSize

Größe der gerätespezifischen Informationen in Bytes.

dwDevSpecificOffset

Offset vom Anfang der Struktur bis zum variabel dimensionierten Feld, das gerätespezifische Informationen enthält. Die Größe des Felds wird von dwDevSpecificSize angegeben.

dwPredictiveAutoTransferStates

LINECALLSTATE_ Konstanten, wobei der Eintrag dazu führt, dass der Aufruf blind an die angegebene Zieladresse übertragen wird. Legen Sie auf 0 (null) fest, wenn die automatische Übertragung nicht gewünscht ist.

dwTargetAddressSize

Größe der wählbaren Zieladresszeichenfolge einschließlich des NULL-Abschlusszeichens in Byte.

dwTargetAddressOffset

Offset vom Anfang der Struktur zu einer Zeichenfolge, die die wählbare Zieladresse angibt (nicht dwAddressID); wird bei bestimmten automatischen Aktionen verwendet. Gibt im Fall von Predictive Dialing die Adresse an, an die der Anruf automatisch übertragen werden soll. Die Größe der Zeichenfolge wird von dwTargetAddressSize angegeben.

Dies ist im Wesentlichen die gleiche Zeichenfolge, die an lineBlindTransfer übergeben würde, wenn die automatische Übertragung nicht verwendet würde. Legen Sie auf 0 (null) fest, wenn die automatische Übertragung nicht gewünscht ist. Gibt im Fall einer No Hold Conference die Adresse an, die an den Anruf adressiert werden soll. Im Fall einer Ein-Schritt-Übertragung gibt die Adresse an, die im Beratungsgespräch gewählt werden soll.

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 in der Senderichtung des Aufrufs gewünscht wird. 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 in der Empfangsrichtung des Anrufs gewünscht wird. 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.

dwDeviceClassSize

Größe der Geräteklassenzeichenfolge einschließlich des NULL-Abschlusszeichens in Bytes.

dwDeviceClassOffset

Offset vom Anfang der Struktur zu einer NULL-endendierten Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Konfiguration in DeviceConfig angegeben ist. Gültige Geräteklassenzeichenfolgen sind identisch mit denen, die für die lineGetID-Funktion angegeben sind. Die Größe der Zeichenfolge wird von dwDeviceClassSize angegeben.

dwDeviceConfigSize

Größe der Gerätekonfigurationsdaten in Bytes.

dwDeviceConfigOffset

Offset vom Anfang der -Struktur bis zur undurchsichtigen Konfigurationsdatenstruktur. Dieser Wert wird im dwStringSize-Element in der VARSTRING-Struktur zurückgegeben, die von lineGetDevConfig zurückgegeben wird. Wenn die Größe null ist, wird die Standardgerätekonfiguration verwendet. Dadurch kann die Anwendung die Gerätekonfiguration festlegen, bevor der Aufruf initiiert wird. Die Größe des Felds wird durch dwDeviceConfigSize angegeben.

dwCallDataSize

Größe der von der Anwendung festgelegten Aufrufdaten in Bytes.

dwCallDataOffset

Offset vom Anfang der -Struktur zu den von der Anwendung festgelegten Aufrufdaten, die anfänglich an den Aufruf angefügt werden sollen. Die Größe des Felds wird von dwCallDataSize angegeben.

dwNoAnswerTimeout

Anzahl der Sekunden nach Abschluss des Wählens, die der Anruf im Status PROCEEDING oder RINGBACK warten darf, bevor er vom Dienstanbieter mit einem LINECALLSTATE_DISCONNECTED und LINEDISCONNECTMODE_NOANSWER automatisch abgebrochen wird. Der Wert 0 gibt an, dass die Anwendung keinen automatischen Aufrufabbruch wünscht.

dwCallingPartyIDSize

Größe der Aufrufer-ID, einschließlich des NULL-Abschlussators in Bytes, einschließlich des NULL-Endzeichens.

dwCallingPartyIDOffset

Offset vom Anfang der Struktur zu einer NULL-Zeichenfolge, die die Identität der Partei angibt, die den Aufruf platziert. Wenn der Inhalt des Bezeichners akzeptabel ist und ein Pfad verfügbar ist, übergibt der Dienstanbieter den Bezeichner an die aufgerufene Partei, um die Identität der aufrufenden Partei anzugeben. Die Größe des Felds wird durch dwCallingPartyIDSize angegeben.

dwAddressType

Adresstyp , der für den Anruf verwendet wird. 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) verwenden, der variabel groß ist.

Diese Struktur wird beim Einrichten eines Aufrufs als Parameter für lineMakeCall verwendet. Ihre Felder ermöglichen es der Anwendung, die vom Netzwerk angeforderte Dienstqualität sowie eine Vielzahl von ISDN-Aufrufsetupparametern anzugeben. Wenn keine LINECALLPARAMS-Struktur für lineMakeCall bereitgestellt wird, wird ein STANDARDMÄßIGER POTS-Sprachanruf mit den oben aufgeführten Standardwerten angefordert.

Hinweis Die Felder DialParams bis dwDevSpecificOffset werden ignoriert, wenn ein lpCallParams-Parameter mit der funktion lineOpen angegeben wird.
 
Die Member dwPredictiveAutoTransferStates bis dwCallingPartyIDOffset sind nur für Anwendungen verfügbar, die das Leitungsgerät mit einer API-Version von 2.0 oder höher öffnen.

Anforderungen

   
Kopfzeile tapi.h

Weitere Informationen

LINEDEVCAPS

LINEDIALPARAMS

LINETRANSLATEOUTPUT

TSPI_lineMakeCall

VARSTRING

lineBlindTransfer

lineGetDevConfig

lineGetID

lineMakeCall

lineÖffnen

lineTranslateAddress