TSPI_phoneSetVolume-Funktion (tspi.h)
Die TSPI_phoneSetVolume-Funktion legt die Lautstärke der Lautsprecherkomponente des angegebenen Hookswitch-Geräts auf die angegebene Ebene fest.
Syntax
LONG TSPIAPI TSPI_phoneSetVolume(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdPhone
Der Griff zum Telefon, der den Lautsprecher enthält, dessen Lautstärke festgelegt werden soll.
dwHookSwitchDev
Gibt das Hookswitch-Gerät an, dessen Lautstärke festgelegt werden soll. Dieser Parameter verwendet eine der PHONEHOOKSWITCHDEV_ Konstanten.
dwVolume
Ein DWORD , das die neue Volumeebene des Hookswitch-Geräts angibt. 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_INVALHOOKSWITCHDEV, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Bemerkungen
Keine.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |