PFAX_LINECALLBACK callback function (faxdev.h)
The FaxLineCallback function is an application-defined or library-defined callback function that the fax service calls to deliver Telephony Application Programming Interface (TAPI) events to the fax service provider (FSP).
The PFAX_LINECALLBACK data type is a pointer to a FaxLineCallback function. FaxLineCallback is a placeholder for an application-defined or library-defined function name.
Syntax
PFAX_LINECALLBACK PfaxLinecallback;
void PfaxLinecallback(
[in] HANDLE FaxHandle,
[in] DWORD hDevice,
[in] DWORD dwMessage,
DWORD_PTR dwInstance,
[in] DWORD_PTR dwParam1,
[in] DWORD_PTR dwParam2,
[in] DWORD_PTR dwParam3
)
{...}
Parameters
[in] FaxHandle
Type: HANDLE
Specifies a fax handle returned by the FaxDevStartJob function.
[in] hDevice
Type: DWORD
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.
[in] dwMessage
Type: DWORD
Specifies a line device or a call device message.
dwInstance
Type: DWORD_PTR
Reserved; should not be used by the FSP.
[in] dwParam1
Type: DWORD_PTR
Specifies a parameter for the message. For information about parameter values passed in this structure, see Line Device Messages in the TAPI documentation.
[in] dwParam2
Type: DWORD_PTR
Specifies a parameter for the message.
[in] dwParam3
Type: DWORD_PTR
Specifies a parameter for the message.
Return value
None
Remarks
The FSP must register the FaxLineCallback callback function by passing its address when the fax service calls the FaxDevInitialize function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional, Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | faxdev.h |
See also
Fax Service Provider Functions