PHONE_CREATE
The
PHONE_CREATE message is sent to inform applications of the creation of a new
phone device.
PHONE_CREATE
hPhone = (HPHONE) hPhoneDev;
dwCallbackInstance = (DWORD) 0;
dwParam1 =
(DWORD) idDevice;
dwParam2 =
(DWORD) 0;
dwParam3 =
(DWORD) 0;
Parameters
hPhone
Unused.
dwCallbackInstance
Unused.
dwParam1
The dwDeviceID
of the newly-created device.
dwParam2
Unused.
dwParam3
Unused.
Return Values
No return
value.
Remarks
Applications
that negotiated API versoin 0x00010003 are sent a PHONE_STATE message
specifying PHONESTATE_REINIT, which requires them to shut down their use of the
API and call phoneInitialize again to obtain the new number of devices.
However, TAPI version 1.4 and above do not require all applications to
shut down before allowing applications to reinitialize; reinitialization can
take place immediately when a new device is created.
Applications
supporting TAPI version 0x00010004 or above are sent a PHONE_CREATE message.
This informs them of the existence of the new device and its new device ID. The
application can then choose whether or not to attempt working with the new
device at its leisure.
See Also