phoneGetRing
The phoneGetRing
function enables an application to query the specified open phone device as to
its current ring mode.
LONG phoneGetRing(
|
HPHONE hPhone, |
|
|
LPDWORD lpdwRingMode, |
|
|
LPDWORD lpdwVolume |
|
|
); |
|
Parameters
hPhone
A handle to
the open phone device.
lpdwRingMode
The ringing
pattern with which the phone is ringing. Zero indicates that the phone is not
ringing.
lpdwVolume
The 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
Returns zero
if the request is successful or a negative error number if an error has
occurred. Possible return values are:
PHONEERR_INVALPHONEHANDLE,
PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL,
PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL,
PHONEERR_UNINITIALIZED.
Remarks
The service
provider defines the actual audible ringing patterns corresponding to each of
phone's ring modes.