Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function enables an application to query the specified open phone device as to its current ring mode.
LONG WINAPI phoneGetRing(HPHONEhPhone,LPDWORDlpdwRingMode,LPDWORDlpdwVolume);
Parameters
- hPhone
Handle to the open phone device. - lpdwRingMode
Ringing pattern with which the phone is ringing. Zero indicates that the phone is not ringing. - lpdwVolume
Volume level with which the phone is ringing. This is a number in the range 0x00000000 (silence) to 0x0000FFFF (maximum volume). The actual granularity and quantization of volume settings in this range are service provider-specific.
Return Values
Zero indicates success. A negative error number indicates that an error occurred. The following table shows the return values for this function.
| Value | Description |
|---|---|
| PHONEERR_INVALPHONEHANDLE | The phone handle is invalid. |
| PHONEERR_INVALPHONESTATE | The phone state is invalid. |
| PHONEERR_INVALPOINTER | The pointer is invalid. |
| PHONEERR_OPERATIONUNAVAIL | The operation is unavailable. |
| PHONEERR_NOMEM | Not enough memory is available. |
| PHONEERR_RESOURCEUNAVAIL | The resource is unavailable. |
| PHONEERR_OPERATIONFAILED | The operation failed. |
| PHONEERR_UNINITIALIZED | The parameter is uninitialized. |
Remarks
The service provider defines the actual audible ringing patterns corresponding to each of the phone's ring modes.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.
Send Feedback on this topic to the authors