LINE_CREATE

  • Article

This message is sent to inform the application of the creation of a new line device.

LINE_CREATE 
dwDevice = (DWORD) 0; 
dwCallbackInstance = (DWORD) 0; 
dwParam1 = (DWORD) idDevice;
dwParam2 = (DWORD) 0; 
dwParam3 = (DWORD) 0;

Parameters

  • dwDevice
    Unused.
  • dwCallbackInstance
    Unused.
  • dwParam1
    Specifies the hDeviceID of the newly created device.
  • dwParam2
    Unused.
  • dwParam3
    Unused.

Return Values

None.

Remarks

Older applications (that negotiated TAPI version 1.3) 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 1.4 or later are sent a LINE_CREATE message. This informs them of the existence of the new device and its new device identifier. The application can then choose whether or not to attempt working with the new device at its leisure. This message is sent to all applications supporting this or subsequent versions of the API that have called lineInitialize, including those that do not have any line devices open at the time.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Tapi.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

lineInitialize

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.