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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |