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.
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.
Anforderungen
| Kopfzeile | tapi.h |