FAX_LINECALLBACK

The FAX_LINECALLBACK function is an application-defined or library-defined callback function that the fax service calls to deliver TAPI events to the fax service provider.

The PFAX_LINECALLBACK data type is a pointer to a FAX_LINECALLBACK function. FAX_LINECALLBACK is a placeholder for an application-defined or library-defined function name.

void CALLBACK FAX_LINECALLBACK(
  HANDLE FaxHandle,     // fax handle 
  DWORD hDevice,        // line or call device handle 
  DWORD dwMessage,      // line or call device message 
  DWORD_PTR dwInstance, // instance data 
  DWORD_PTR dwParam1,   // message parameter 
  DWORD_PTR dwParam2,   // message parameter 
  DWORD_PTR dwParam3    // message parameter 
);

Parameters

FaxHandle

[in] Specifies a fax handle returned by the FaxDevStartJob function.

hDevice

[in] Specifies a handle to either a line device or a call device. To determine whether this handle is a line handle or a call handle, use the context that the dwMessage parameter provides.

dwMessage

[in] Specifies a line device or a call device message.

dwInstance

[in] Specifies job-specific instance data passed back to the application. This data is specified by the application in a call to the lineInitializeEx function. This DWORD value is not interpreted by TAPI.

dwParam1

[in] Specifies a parameter for the message. For information about parameter values passed in this structure, see Line Device Messages in the TAPI documentation.

dwParam2

[in] Specifies a parameter for the message.

dwParam3

[in] Specifies a parameter for the message.

Return Values

None.

Remarks

The fax service provider must register the FAX_LINECALLBACK callback function by passing its address when the fax service calls the FaxDevInitialize function.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxdev.h.
  Import Library: User-defined.

See Also

Fax Service Provider Application Programming Interface Overview, Fax Service Provider Functions, FaxDevStartJob, FaxDevInitialize, lineInitializeEx