Freigeben über


phoneSetRing-Funktion (tapi.h)

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.

Hinweise

Der Dienstanbieter definiert die tatsächlichen akustischen Klingelmuster, die den einzelnen Klingelmodi des Telefons entsprechen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi.h
Bibliothek Tapi32.lib
DLL Tapi32.dll

Weitere Informationen

PHONECAPS

PHONE_REPLY

Zusätzliche Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz