LINEMESSAGE structure (tapi.h)

The LINEMESSAGE structure contains parameter values specifying a change in status of the line the application currently has open. The lineGetMessage function returns the LINEMESSAGE structure.

Syntax

typedef struct linemessage_tag {
  DWORD     hDevice;
  DWORD     dwMessageID;
  DWORD_PTR dwCallbackInstance;
  DWORD_PTR dwParam1;
  DWORD_PTR dwParam2;
  DWORD_PTR dwParam3;
} LINEMESSAGE, *LPLINEMESSAGE;

Members

hDevice

Handle to either a line device or a call. The nature of this handle (line handle or call handle) can be determined by the context provided by dwMessageID.

dwMessageID

Line or call device message.

dwCallbackInstance

Instance data passed back to the application, which was specified by the application in the dwCallBackInstance parameter of lineInitializeEx. This DWORD is not interpreted by TAPI.

dwParam1

Parameter for the message.

dwParam2

Parameter for the message.

dwParam3

Parameter for the message.

Remarks

For information about parameter values passed in this structure, see Line Device Messages.

Requirements

Requirement Value
Header tapi.h

See also

lineGetMessage

lineInitializeEx