PHONE_REMOVE  E1C1ME

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_CLOSEFH4LO3 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 phoneInitializeExE45JM7, 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_STATE30RA.WH 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

PHONE_CLOSE, PHONE_STATE, phoneInitialize, phoneInitializeEx