|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
LINE_LINEDEVSTATE htLine = (HTAPILINE) hLineDevice; htCall = (HTAPICALL) 0; dwMsg = (DWORD) LINE_LINEDEVSTATE; dwParam1 = (DWORD) LineDevState; dwParam2 = (DWORD) DevStateData1; dwParam3 = (DWORD) DevStateData2;
The TAPI opaque object handle to the line device.
The value LINE_LINEDEVSTATE.
Specifies the callback instance supplied when opening the line.
Specifies the line device status item that has changed. This parameter uses one or more of the LINEDEVSTATE_ constants.
The interpretation of this parameter depends on the value of dwParam1. If dwParam1is LINEDEVSTATE_RINGING, dwParam2contains the ring mode with which the switch instructs the line to ring. Valid ring modes are numbers in the range one to dwNumRingModes, where dwNumRingModesis a line device capability.
The interpretation of this parameter depends on the value of dwParam1. If dwParam1is LINEDEVSTATE_RINGING, dwParam3contains the ring count for this ring event. The ring count starts at zero.
The sending of this message can be controlled through TSPI_lineSetStatusMessages. The service provider must send LINE_LINEDEVSTATE messages for at least the set of status changes selected through that procedure. The service provider can send more than this set, however, it should try to limit its messages to this set for performance reasons. By default all status reporting is disabled.
At the TSPI level, the service provider does not report state changes when the line is opened and closed, since there is only ever one Open outstanding for the device.
For backward compatibility, older service providers would not be expected to generate these values. If they do, TAPI treats them the same as if the service provider were using API version 1.4 or later (as described earlier).
|Windows Embedded CE||Windows CE 1.0 and later|
|Windows Mobile||Windows Mobile Version 5.0 and later|