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 |