phoneSetRing-Funktion (tapi.h)

Artikel
08/26/2023

Die phoneSetRing-Funktion klingelt das angegebene geöffnete Telefongerät mit dem angegebenen Ringmodus und der angegebenen Lautstärke.

Syntax

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

Parameter

hPhone

Handle mit dem geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefongeräts sein.

dwRingMode

Klingelmuster, mit dem das Telefon klingeln soll. Dieser Parameter muss sich innerhalb des Bereichs von 0 bis zum Wert des dwNumRingModes-Elements in der PHONECAPS-Struktur befinden. Wenn dwNumRingModes null ist, kann der Ringmodus des Telefons nicht gesteuert werden. wenn dwNumRingModes 1 ist, gibt ein Wert von 0 für dwRingMode an, dass das Telefon nicht laut (Stille) sein sollte, und andere Werte von 1 bis dwNumRingModes sind gültige Ringmodi für das Telefongerät.

dwVolume

Lautstärkeebene, mit der das Telefon klingelt. Dies ist eine Zahl im Bereich 0x00000000 (Stille) bis 0x0000FFFF (maximale Lautstärke). Die tatsächliche Granularität und Quantisierung der Volumeeinstellungen in diesem Bereich sind dienstanbieterspezifisch. Ein Wert für dwVolume , der sich außerhalb des Bereichs befindet, wird auf den nächstgelegenen Wert im Bereich festgelegt.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALRINGMODE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.