LINE_ADDRESSSTATE (TAPI)

  • Article

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

Header tapi.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

lineGetAddressStatus
lineGetStatusMessages
lineSetStatusMessages