LINE_ADDRESSSTATE (TAPI)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message is sent when the status of an address changes on a line that is currently open by the application. The application can invoke the lineGetAddressStatus function to determine the current status of the address.

Syntax

LINE_ADDRESSSTATE 
    dwDevice = (DWORD) hLine;
    dwCallbackInstance = (DWORD) hCallback;
    dwParam1 = (DWORD) idAddress; 
    dwParam2 = (DWORD) AddressState;
    dwParam3 = (DWORD) 0;

Parameters

• dwDevice
  Handle to the line device.

• dwCallbackInstance
  Callback instance supplied when opening the line.

• dwParam1
  Address identifier of the address that changed status.

• dwParam2
  Value that specifies the address state that changed. It can be a combination of values using the LINEADDRESSSTATE.

• dwParam3
  Not used by this message. Value is NULL.

Return Value

None.

Remarks

The LINE_ADDRESSSTATE message is sent to any application that has opened the line device and that has enabled this message. The sending of this message for the various status items can be controlled and queried using lineGetStatusMessages and lineSetStatusMessages. By default, address status reporting is disabled.

Requirements

See Also

Reference

lineGetAddressStatus
lineGetStatusMessages
lineSetStatusMessages