phoneSetVolume-Funktion (tapi.h)

Die phoneSetVolume-Funktion legt die Lautstärke der Lautsprecherkomponente des angegebenen Hookswitch-Geräts auf die angegebene Ebene fest.

Syntax

LONG phoneSetVolume(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwVolume
);

Parameter

hPhone

Handle zum geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefons sein.

dwHookSwitchDev

Hookswitch-Gerät, dessen Lautstärke festgelegt werden soll, eine der PHONEHOOKSWITCHDEV_ Konstanten.

dwVolume

Neue Volumeeinstellung des Geräts. Der dwVolume-Parameter gibt die Volumeebene des Hookswitch-Geräts an. 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. Ein Wert für dwVolume , der außerhalb des Bereichs liegt, wird auf den nächsten Wert im Bereich festgelegt.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Anforderungen

Weitere Informationen

PHONE_REPLY

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz