lineGenerateDigitsA-Funktion (tapi.h)

Die lineGenerateDigits-Funktion initiiert die Generierung der angegebenen Ziffern für den angegebenen Aufruf als Inbandtöne mithilfe des angegebenen Signalisierungsmodus. Das Aufrufen dieser Funktion mit einem NULL- Wert für lpszDigits alle aktuell ausgeführten Zifferngenerierung abbricht. Das Aufrufen von lineGenerateDigits oder lineGenerateTone während die Generierung von Ziffern in Bearbeitung ist, bricht die aktuelle Zifferngenerierung oder tongenerierung ab und initiiert die Generierung der zuletzt angegebenen Ziffern oder Töne.

Syntax

LONG lineGenerateDigitsA(
  HCALL  hCall,
  DWORD  dwDigitMode,
  LPCSTR lpszDigits,
  DWORD  dwDuration
);

Parameter

hCall

Behandeln Sie den Anruf. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus hCall- kann ein beliebiger Zustand sein. TAPI erzwingt keine Anrufstatusanforderungen, einige Tapi-Dienstanbieter erfordern jedoch möglicherweise, dass sich der hCall im LINECALLSTATE_CONNECTED Zustand befindet.

dwDigitMode

Format, das für die Signalisierung dieser Ziffern verwendet werden soll. Beachten Sie, dass dwDigitMode- nur einen einzigen Flagsatz aufweisen kann. Dieser Parameter verwendet eine der LINEDIGITMODE_ Konstanten.

lpszDigits

Zeigen Sie auf einen NULL--terminated-Zeichenpuffer, der die zu generierenden Ziffern enthält. Gültige Zeichen sind die für die LINEDIGITMODE_ Konstanten in dwDigitModesangegeben.

Darüber hinaus ist das Komma (,) auch ein gültiges Zeichen. Ein Komma fügt eine zusätzliche Verzögerung zwischen der Signalisierung der vorherigen und nächsten Ziffer ein, die getrennt wird. Die Dauer dieser Pause ist die Konfiguration definiert, und die Zeilengerätefunktionen geben diese Dauer an. Mehrere Kommas können zum Einfügen längerer Pausen verwendet werden. Ungültige Ziffern werden während der Generierung ignoriert, anstatt als Fehler gemeldet zu werden.

Das Ausrufezeichen (!) ist ein gültiges Zeichen. Dieses Zeichen verursacht einen "Hookflash"-Vorgang, wie für einwählbare Adressenbeschrieben.

dwDuration

Sowohl die Dauer in Millisekunden der DTMF-Ziffern als auch der Impuls- und DTMF-Zwischenabstände. Ein Wert von 0 verwendet einen Standardwert. Der dwDuration Parameter muss sich innerhalb des Bereichs befinden, der von MinDialParams und MaxDialParams in LINEDEVCAPS-angegeben wird. Wenn der Wert außerhalb des Bereichs liegt, wird der tatsächliche Wert auf den nächstgelegenen Wert im Bereich festgelegt.

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Bemerkungen

Die lineGenerateDigits--Funktion gilt als erfolgreich abgeschlossen, wenn die Zifferngenerierung erfolgreich initiiert wurde und nicht, wenn alle Ziffern generiert wurden. Im Gegensatz zu lineDial, die Ziffern in netzwerkabhängiger Weise wählt, garantiert lineGenerateDigits garantiert, dass die Ziffern als Inbandtöne über den Sprachkanal mithilfe von DTMF- oder Hookswitch-Wählimpulsen erzeugt werden. Die lineGenerateDigits Funktion eignet sich in der Regel nicht für Anrufe oder Einwahlen. Es ist für end-to-End-Signalisierungen über einen etablierten Anruf vorgesehen.

Nachdem alle Ziffern in lpszDigits generiert wurden oder nachdem die Zifferngenerierung abgebrochen oder abgebrochen wurde, wird eine LINE_GENERATE Nachricht an die Anwendung gesendet.

Nur eine Anforderung der Bandgenerierung (Tongenerierung oder Zifferngenerierung) darf pro Anruf in allen Anwendungen ausgeführt werden, die Besitzer des Anrufs sind. Die Zifferngenerierung bei einem Anruf wird abgebrochen, indem entweder eine anforderung zur Generierung einer anderen Ziffer oder eine Anforderung zur Tongenerierung initiiert wird. Um die aktuelle Zifferngenerierung abzubrechen, kann die Anwendung lineGenerateDigits aufrufen und NULL- für den parameter lpszDigit s angeben.

Je nach Dienstanbieter und Hardware kann die Anwendung die von ihr generierten Ziffern überwachen. Wenn dies nicht gewünscht ist, kann die Anwendung die Ziffernüberwachung beim Generieren von Ziffern deaktivieren.

Anforderungen

Siehe auch

LINEDEVCAPS-

LINE_GENERATE

Ergänzende Line-Service-Funktionen

TAPI 2.2 Referenzübersicht

lineDial-

lineGenerateTone