LINE_CREATE (TSPI)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message is sent to the LINEEVENT callback function when it desires to create a new device.

Syntax

LINE_CREATE
    htLine = (HTAPILINE) 0;
    htCall = (HTAPICALL) 0;
    dwMsg = (DWORD) LINE_CREATE;
    dwParam1 = (DWORD) hProvider;
    dwParam2 = (DWORD) lpdwDeviceId;
    dwParam3 = (DWORD) 0;

Parameters

• htLine
  Not used.

• htCall
  Not used.

• dwMsg
  The value LINE_CREATE.

• dwParam1
  The service provider handle (hProvider) as received in TSPI_providerEnumDevices.

• dwParam2
  Contains a pointer to a device identifier, which TAPI will fill.

• dwParam3
  Not used.

Return Value

None.

Remarks

This message is sent to the LINEEVENT callback entry point in TAPI. The service provider receives a pointer to this callback in the TSPI_providerEnumDevices function and in each TSPI_lineOpen function; the LINE_CREATE message can be sent to the LINEEVENT callback function given to any open line or at startup.

Devices cannot be removed dynamically. If a service provider wants to remove a line from service, it can send a LINE_LINEDEVSTATE (TSPI) (LINEDEVSTATE_OUTOFSERVICE) message. It would then refuse (for example, by returning LINEERR_INVALLINESTATE) to perform any operation with the device until it returns to service or the provider is shut down and restarted (in which case the device could not be declared in TSPI_providerEnumDevices, effectively removing it from the system).

For backward compatibility, older service providers are not expected to send this message. If they do, the message is treated in the same manner as described earlier for new service providers.

Requirements

See Also

Reference

LINEEVENT
TSPI_lineOpen
TSPI_providerCreateLineDevice
TSPI_providerEnumDevices
TSPI_providerInit
TSPI_providerShutdown
LINE_LINEDEVSTATE (TSPI)