lineSetNumRings-Funktion (tapi.h)

Artikel
03/02/2024

Die lineSetNumRings-Funktion legt die Anzahl der Ringe fest, die auftreten müssen, bevor ein eingehender Anruf angenommen wird. Diese Funktion kann verwendet werden, um eine Funktion im Gebührensparmodus zu implementieren. Sie ermöglicht es mehreren unabhängigen Anwendungen, jeweils die Anzahl der Ringe zu registrieren. Die Funktion lineGetNumRings gibt die Mindestanzahl der angeforderten Ringe zurück. Es kann von der Anwendung verwendet werden, die eingehende Anrufe beantwortet, um die Anzahl der Ringe zu bestimmen, die vor der Anrufanhörung gewartet werden soll.

Syntax

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

Parameter

hLine

Handle für das Open Line-Gerät.

dwAddressID

Adresse auf dem Leitungsgerät. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

dwNumRings

Anzahl der Ringe, bevor ein Anruf beantwortet werden sollte, um die Anforderungen der Mautschoner von allen Anwendungen zu berücksichtigen.

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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Hinweise

Die Funktionen lineGetNumRings und lineSetNumRings bieten in Kombination einen Mechanismus zur Unterstützung der Implementierung von Features für die Kostenersparnis in mehreren unabhängigen Anwendungen. Wenn keine Anwendung jemals lineSetNumRings aufruft, gibt lineGetNumRings 0xFFFFFFFF zurück.

Eine Anwendung, die der Besitzer eines Anrufs im Angebotsstatus ist und eine LINE_LINEDEVSTATEklingelnde Nachricht empfangen hat, sollte eine Anzahl von Ringen warten, die der von lineGetNumRings zurückgegebenen Zahl entspricht, bevor sie den Anruf entgegen nimmt, um die Einstellungen für die Gebührenschoner in allen Anwendungen zu berücksichtigen. Für jeden Ringzyklus wird eine separate LINE_LINEDEVSTATE Klingelnachricht an die Anwendung gesendet, sodass die Anwendung diese Nachrichten zählen sollte. Wenn dieser Anruf getrennt wird, bevor er angenommen wird, und kurz darauf ein weiterer Anruf eingeht, sollte die LINE_CALLSTATE Nachricht der Anwendung ermöglichen, festzustellen, dass das Klingeln mit dem zweiten Anruf zusammenhängt.

Wenn die Anrufklassifizierung von TAPI durchgeführt wird, indem eingehende Anrufe unbekannter Medientypen entgegennehmen und der Mediendatenstrom gefiltert wird, berücksichtigt TAPI auch diese Nummer.

Hinweis Dieser Vorgang ist rein informal und wirkt sich nicht auf den Zustand von Anrufen auf dem Leitungsgerät aus.