phoneGetRing-Funktion (tapi.h)

Die phoneGetRing-Funktion ermöglicht es einer Anwendung, das angegebene geöffnete Telefongerät im aktuellen Klingelmodus abzufragen.

Syntax

LONG phoneGetRing(
  HPHONE  hPhone,
  LPDWORD lpdwRingMode,
  LPDWORD lpdwVolume
);

Parameter

hPhone

Handle zum geöffneten Telefongerät.

lpdwRingMode

Klingelmuster, mit dem das Telefon klingelt. Null gibt an, dass das Telefon nicht klingelt.

lpdwVolume

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.

Rückgabewert

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Hinweise

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

Anforderungen

Weitere Informationen

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz