Freigeben über


ITAutomatedPhoneControl::p ut_AutoKeypadTones-Methode (tapi3if.h)

Die put_AutoKeypadTones-Methode legt die AutoKeypadTones-Eigenschaft für dieses Telefon fest. Wenn dieses Feature aktiviert ist, wird automatisch ein Ziffernton wiedergegeben, wenn eine Tastaturtaste gedrückt wird.

Syntax

HRESULT put_AutoKeypadTones(
  [in] VARIANT_BOOL fEnabled
);

Parameter

[in] fEnabled

Wenn VARIANT_TRUE, ist die automatische Tongenerierung der Telefontaste aktiviert. Wenn VARIANT_FALSE, ist die Tongenerierung der Tastatur deaktiviert. Der Standardwert ist VARIANT_TRUE.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlerwert zurückgegeben.

Hinweise

Wenn das Telefongerät eine Taste als PBS_DOWN meldet, wird der Ton wiedergegeben, bis das Telefongerät ein PBS_UP Ereignis meldet oder bis die Mindestdauer abgelaufen ist, je nachdem, was länger ist. (Die Mindestdauer wird durch die AutoKeypadTonesMinimumDuration-Eigenschaft bestimmt.)

Die Tongenerierung der Tastatur tritt nur auf, wenn das Telefon aushookt. Wenn derzeit ein anderer Ton, z. B. "Ringback", wiedergegeben wird, unterbricht der Tastaturton diesen Ton und stellt ihn automatisch wieder her, nachdem der Ton der Tastatur beendet wurde.

Die AutoKeypadTones-Eigenschaft funktioniert nur, wenn der Wert der PhoneHandlingEnabled-Eigenschaft VARIANT_TRUE ist. Sie können die AutoKeypadTones-Eigenschaft jederzeit festlegen. Die Neukonfiguration wird beim nächsten Drücken der Telefontaste wirksam.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (Tapi3.h einschließen)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

ITAutomatedPhoneControl

get_AutoKeypadTones

put_AutoKeypadTonesMinimumDuration

put_PhoneHandlingEnabled