description | ms.assetid | title | ms.topic | ms.date |
---|---|---|---|---|
The TAPI PHONE\_BUTTON message is sent to notify the application that button press monitoring is enabled if it has detected a button press on the local phone. |
fe47eed7-89d1-488b-b945-9e1aedc1f63c |
PHONE_BUTTON message (Tapi.h) |
reference |
05/31/2018 |
The TAPI PHONE_BUTTON message is sent to notify the application that button press monitoring is enabled if it has detected a button press on the local phone.
-
hPhone
-
A handle to the phone device.
-
dwCallbackInstance
-
The application's callback instance provided when opening the phone device.
-
dwParam1
-
The button/lamp identifier of the button that was pressed. Note that button identifiers zero through 11 are always the KEYPAD buttons, with '0' being button identifier zero, '1' being button identifier 1 (and so on through button identifier 9), and with '*' being button identifier 10, and '#' being button identifier 11. Additional information about a button identifier is available with phoneGetDevCaps and phoneGetButtonInfo.
-
dwParam2
-
The button mode of the button. This parameter uses one of the PHONEBUTTONMODE_ constants.
-
dwParam3
-
Specifies whether this is a button-down event or a button-up event. This parameter uses one of the PHONEBUTTONSTATE_ constants.
No return value.
A PHONE_BUTTON message is sent whenever a button changes state. An application is guaranteed that for each button down event, it is eventually sent a corresponding button up event. A service provider that is incapable of detecting the actual button up is required to generate the button up message shortly after the button down message for each button press.
Requirement | Value |
---|---|
TAPI version |
Requires TAPI 2.0 or later |
Header |
|