LINE_CREATE
The
LINE_CREATE message is sent to inform the application of the creation of a new
line device.
dwDevice = (DWORD) 0;
dwCallbackInstance = (DWORD) 0;
dwParam1 =
(DWORD) idDevice;
dwParam2 =
(DWORD) 0;
dwParam3 =
(DWORD) 0;
Parameters
dwDevice
Unused.
dwCallbackInstance
Unused.
dwParam1
The dwDeviceID
of the newly-created device.
dwParam2
Unused.
dwParam3
Unused.
Return Values
No return
value.
Remarks
Older
applications (which negotiated TAPI version 0x00010003) are sent a
LINE_LINEDEVSTATE message specifying LINEDEVSTATE_REINIT, which requires them
to shut down their use of the API and call lineInitialize again to
obtain the new number of devices. Unlike previous versions of TAPI, however,
this version does not require all applications to shut down before
allowing applications to reinitialize; reinitialization can take place
immediately when a new device is created (complete shutdown is still required when
a service provider is removed from the system).
Applications
supporting TAPI version 0x00010004 or above are sent a LINE_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. This message will be sent to all applications supporting
this or subsequent versions of the API which have called lineInitialize
or lineInitalizeEx, including those that do not have any line devices
open at the time.
See Also