ITAutomatedPhoneControl::get_AutoKeypadTones-Methode (tapi3if.h)

Artikel
03/04/2024

Die get_AutoKeypadTones-Methode ruft die AutoKeypadTones-Eigenschaft für dieses Telefon ab. Wenn diese Funktion aktiviert ist, wird automatisch ein Ziffernton wiedergegeben, wenn eine Tastenkombination gedrückt wird.

Syntax

HRESULT get_AutoKeypadTones(
  [out] VARIANT_BOOL *pfEnabled
);

Parameter

[out] pfEnabled

VARIANT_TRUE, wenn die automatische Feedbackgenerierung der Telefontaste für dieses Telefon aktiviert ist. VARIANT_FALSE, wenn die automatische Tongenerierung von Telefontasten für dieses Telefon deaktiviert ist.

Rückgabewert

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

Hinweise

Wenn das Telefongerät meldet, dass eine Schaltfläche als PBS_DOWN gedrückt wird, wird der Ton wiedergegeben, bis das Telefongerät ein PBS_UP Ereignis meldet oder bis die Mindestdauer abgelaufen ist, je nachdem, welcher Wert länger ist. (Die Mindestdauer wird durch die AutoKeypadTonesMinimumDuration-Eigenschaft bestimmt.)

Die Tongenerierung der Tastatur tritt nur auf, wenn das Telefon offhook ist. Wenn derzeit ein anderer Ton, z. B. Ringback, wiedergegeben wird, unterbricht der Tastenton diesen Ton und stellt ihn automatisch wieder her, nachdem der Tastenton abgeschlossen ist.

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 wirksam, wenn die Tastenkombination des Telefons das nächste Mal gedrückt wird.