lineMonitorDigits-Funktion (tapi.h)

Artikel
08/26/2023

Die lineMonitorDigits-Funktion aktiviert und deaktiviert die ungepufferte Erkennung von Ziffern, die beim Aufruf empfangen werden. Jedes Mal, wenn eine Ziffer des angegebenen Ziffernmodus erkannt wird, wird eine Meldung an die Anwendung gesendet, die angibt, welche Ziffer erkannt wurde.

Syntax

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

Parameter

hCall

Handle an den Aufruf, an dem Ziffern erkannt werden sollen. Der Aufrufstatus von hCall kann ein beliebiger Zustand sein, außer im Leerlauf oder getrennt.

dwDigitModes

Ziffernmodus oder -modi, die überwacht werden sollen. Wenn dwDigitModes null ist, wird die Ziffernüberwachung abgebrochen. Dieser Parameter verwendet eine oder mehrere der LINEDIGITMODE_ Konstanten.

Rückgabewert

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

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

Hinweise

Diese Funktion gilt als erfolgreich, wenn die Ziffernüberwachung ordnungsgemäß initiiert wurde und nicht, wenn die Ziffernüberwachung beendet wurde. Die Ziffernüberwachung bleibt wirksam, bis sie explizit deaktiviert wird, indem lineMonitorDigits aufgerufen wird, wobei dwDigitModes auf 0 festgelegt ist, bis der Aufruf in den Leerlauf wechselt oder wenn die Anwendung die Zuordnung des Anrufhandles für den Anruf aufgehoben. 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, wird eine LINE_MONITORDIGITS-Nachricht an die Anwendung gesendet, die die erkannte Ziffer als Parameter übergibt.

Eine Anwendung kann lineMonitorDigits verwenden, um die Erkennung nicht gepufferter Ziffern zu aktivieren oder zu deaktivieren. Es kann lineGatherDigits für die Erkennung gepufferter Ziffern verwenden. Nachdem das Sammeln gepufferter Ziffern abgeschlossen ist, wird eine LINE_GATHERDIGITS-Nachricht an die Anwendung gesendet. Die Erkennung gepufferter und ungepufferter Ziffern kann gleichzeitig für denselben Aufruf aktiviert werden.

Die Überwachung von Ziffern bei einer Telefonkonferenz gilt nur für den hConfCall, nicht für die einzelnen teilnehmenden Anrufe.