FaxDevInitialize

The fax service calls the FaxDevInitialize function each time the service starts, after it loads the fax service provider DLL. Each fax service provider must export the FaxDevInitialize function.

BOOL WINAPI FaxDevInitialize(
  HLINEAPP LineAppHandle, // handle to fax service TAPI registration
  HANDLE HeapHandle,      // handle to heap for memory allocation
  PFAX_LINECALLBACK *LineCallbackFunction, 
                          // pointer to line callback function
  PFAX_SERVICE_CALLBACK FaxServiceCallback 
                          // pointer to service callback function
);

Parameters

LineAppHandle

[in] Specifies a handle to the fax service's registration with TAPI. For more information, see lineInitializeEx.

HeapHandle

[in] Specifies a handle to a heap that the fax service provider must use for all memory allocations.

LineCallbackFunction

[out] Pointer to a variable that receives a pointer to a TAPI line callback function.

FaxServiceCallback

[in] Pointer to a service callback function. Although this function is not used currently, in the future it will provide functionality from the fax service to the fax service provider.

Return Values

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. In this case, the current instance of the fax service does not use this fax service provider. All devices that this fax service provider supports are unable to send or receive faxes. To get extended error information, the fax service calls GetLastError.

Remarks

The fax service provider must respond to the FaxDevInitialize function by performing any necessary initialization.

The fax service provider must supply the FAX_LINECALLBACK function specified by the LineCallbackFunction parameter. The fax service calls this function when it needs to deliver a TAPI event to the fax service provider.

For more information, see Virtual Fax Devices.

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, FAX_LINECALLBACK, FaxDevVirtualDeviceCreation, lineInitializeEx