phoneGetVolume-Funktion (tapi.h)

Die phoneGetVolume-Funktion gibt die Lautstärkeeinstellung des Hookswitch-Geräts des angegebenen Telefons zurück.

Syntax

LONG phoneGetVolume(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwVolume
);

Parameter

hPhone

Handle zum geöffneten Telefongerät.

dwHookSwitchDev

Ein einzelnes Hookswitch-Gerät, dessen Lautstärke abgefragt wird. Dieser Parameter verwendet eine der PHONEHOOKSWITCHDEV_ Konstanten.

lpdwVolume

Zeiger auf ein DWORD. Die Funktion gibt die aktuelle Lautstärkeeinstellung des Hookswitch-Geräts an dieser Position zurück. 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_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi.h
Bibliothek	Tapi32.lib
DLL	Tapi32.dll

Weitere Informationen

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz