PHONE_REMOVE
The
PHONE_REMOVE message is sent to inform an application of the removal (deletion
from the system) of a phone device. Generally, this is not used for temporary
removals, such as extraction of PCMCIA devices, but only for permanent removals
in which the device would no longer be reported by the service provider if TAPI
were reinitialized.
PHONE_REMOVE
dwDevice = (DWORD) 0;
dwCallbackInstance = (DWORD) 0;
dwParam1 =
(DWORD) dwDeviceID;
dwParam2 =
(DWORD) 0;
dwParam3 =
(DWORD) 0;
Parameters
dwDevice
Reserved; set
to 0.
dwCallbackInstance
Reserved; set
to 0.
dwParam1
Identifier of
the phone device that was removed.
dwParam2
Reserved; set
to 0.
dwParam3
Reserved; set
to 0.
Return Values
No return
value.
Comments and Backward Compatibility
Applications
TAPI version 0x00020000 and above are sent a PHONE_REMOVE message. This informs
them that the device has been removed from the system. The PHONE_REMOVE message
will have been preceded by a PHONE_CLOSE message on each phone handle, if the application
had the phone open. This message will be sent to all applications supporting
TAPI version 0x00020000 or above which have called phoneInitializeEx, including those that do
not have any phone devices open at the time.
Older
applications (which negotiated TAPI version 0x00010004 or below) are sent a PHONE_STATE message specifying
PHONESTATE_REMOVED, followed by a PHONE_CLOSE message. Unlike the PHONE_REMOVE
message, however, these older applications can receive these messages only if
they have the phone open when it is removed. If they do not have the phone
open, their only indication that the device was removed would be receiving a
PHONEERR_NODEVICE when they attempt to access the device.
After a
device has been removed, any attempt to access the device by its device ID will
result in a PHONEERR_NODEVICE error. After all TAPI applications have shutdown
so that TAPI can restart, when TAPI is reinitialized, the removed device will
no longer occupy a device ID.
Implementation
Note
It is TAPI that will return this PHONEERR_NODEVICE after a PHONE_REMOVE
message is received from a service provider; no further calls will be made to
that service provider using that phone device ID.
See Also