TSPI_phoneGetRing-Funktion (tspi.h)
Die TSPI_phoneGetRing-Funktion ermöglicht es einer Anwendung, das angegebene geöffnete Telefongerät im aktuellen Ringmodus abzufragen.
Syntax
LONG TSPIAPI TSPI_phoneGetRing(
HDRVPHONE hdPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
Parameter
hdPhone
Der Griff für das Telefon, dessen Klingelmodus abgefragt werden soll.
lpdwRingMode
Das Klingelmuster, mit dem das Telefon klingelt. Null gibt an, dass das Telefon nicht klingelt.
lpdwVolume
Die Lautstärkeebene, mit der das Telefon klingelt. Dies ist eine Zahl im Bereich von 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 Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Der Dienstanbieter definiert die tatsächlichen akustischen Klingelmuster, die den einzelnen Klingelmodi des Telefons entsprechen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |