TSPI_lineMonitorDigits-Funktion (tspi.h)
Die funktion TSPI_lineMonitorDigits aktiviert und deaktiviert die ungepufferte Erkennung der beim Aufruf empfangenen Ziffern. Jedes Mal, wenn eine Ziffer der angegebenen Ziffernmodi erkannt wird, wird von TAPI eine LINE_MONITORDIGITS Nachricht an die Anwendung gesendet, die angibt, welche Ziffer erkannt wird.
Syntax
LONG TSPIAPI TSPI_lineMonitorDigits(
HDRVCALL hdCall,
DWORD dwDigitModes
);
Parameter
hdCall
Das Handle für den Aufruf, an dem Ziffern erkannt werden sollen. Der Aufrufstatus von hdCall kann ein beliebiger Zustand sein, außer im Leerlauf oder getrennt.
dwDigitModes
Die zu überwachenden Ziffernmodi. Ein dwDigitModes-Parameter mit dem Wert 0 bricht die Ziffernüberwachung ab. Der dwDigitModes-Parameter kann eine der LINEDIGITMODE_ Konstanten aufweisen.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Hinweise
Diese Funktion gibt null (erfolg) zurück, wenn die Ziffernüberwachung ordnungsgemäß initiiert wird, nicht wenn die Ziffernüberwachung beendet wird. Die Ziffernüberwachung bleibt in Kraft, bis sie durch einen Aufruf von TSPI_lineMonitorDigits explizit deaktiviert wird, wobei dwDigitModes auf 0 festgelegt ist, oder bis der Aufruf in den Leerlauf wechselt. Die Funktion muss null zurückgeben, wenn die Ziffernüberwachung abgebrochen wird (d. a. wenn der dwDigitModes-Parameter null ist). Der Dienstanbieter muss die Ziffernüberwachung beenden, wenn der Aufruf im Leerlauf erfolgt. TAPI ruft nicht spontan TSPI_lineMonitorDigits auf, um die Überwachung zu beenden.
Obwohl diese Funktion in jedem Aufrufzustand aufgerufen werden kann, werden Ziffern in der Regel nur erkannt, während sich der Aufruf im Zustand "Verbunden" befindet.
Jedes Mal, wenn eine Ziffer erkannt wird, sendet der Dienstanbieter eine LINE_MONITORDIGITS-Nachricht an TAPI und übergibt die erkannte Ziffer als Parameter. Wenn sowohl LINEDIGITMODE_DTMF als auch LINEDIGITMODE_DTMFEND in dwDigitModes festgelegt sind, werden die beiden LINE_MONITORDIGITS Nachrichten für jede Ziffer gesendet.
TAPI kann TSPI_lineMonitorDigits verwenden, um die Erkennung nicht gepufferter Ziffern zu aktivieren oder zu deaktivieren. Es kann TSPI_lineGatherDigits für die Erkennung gepufferter Ziffern verwenden. Nachdem das Sammeln gepufferter Ziffern abgeschlossen ist, wird eine LINE_GATHERDIGITS Nachricht gesendet. Die Erkennung gepufferter und ungepufferter Ziffern kann gleichzeitig für denselben Aufruf aktiviert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |