TSPI_phoneSetRing-Funktion (tspi.h)
Die TSPI_phoneSetRing-Funktion klingelt das angegebene geöffnete Telefongerät unter Verwendung des angegebenen Ringmodus und der angegebenen Lautstärke.
Syntax
LONG TSPIAPI TSPI_phoneSetRing(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwRingMode,
DWORD dwVolume
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdPhone
Der Griff zum Telefon, das gerungen werden soll.
dwRingMode
Das Klingelmuster, mit dem das Telefon klingelt. Dieser Parameter muss sich innerhalb des Bereichs von null 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 angerufen werden sollte (Stille), und andere Werte von 1 bis dwNumRingModes sind gültige Ringmodi für das Telefongerät.
dwVolume
Die Lautstärkeebene, mit der das Telefon gesungen werden soll. 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. Ein Wert für dwVolume , der sich außerhalb des Bereichs befindet, wird von TAPI an den nächstgelegenen Wert im Bereich geklemmt.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder es ist eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALRINGMODE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Hinweise
Der Dienstanbieter definiert die tatsächlichen akustischen Klingelmuster, die den einzelnen Klingelmodi des Telefons entsprechen.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |