phoneGetRing

This function enables an application to query the specified open phone device as to its current ring mode.

LONG WINAPI phoneGetRing(
  HPHONE hPhone, 
  LPDWORD lpdwRingMode, 
  LPDWORD lpdwVolume
);

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.

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.

The service provider defines the actual audible ringing patterns corresponding to each of the phone's ring modes.

OS Versions: Windows CE 3.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.

Last updated on Saturday, April 10, 2004

Ressources supplémentaires