共用方式為


FaxDevInitialize 函式 (faxdev.h)

傳真服務會在每次服務啟動時呼叫 FaxDevInitialize 函式,然後載入傳真服務提供者 (FSP) DLL。 每個 FSP 都必須匯出 FaxDevInitialize 函式

語法

BOOL FaxDevInitialize(
  [in]  HLINEAPP              LineAppHandle,
  [in]  HANDLE                HeapHandle,
  [out] PFAX_LINECALLBACK     *LineCallbackFunction,
  [in]  PFAX_SERVICE_CALLBACK FaxServiceCallback
);

參數

[in] LineAppHandle

類型: HLINEAPP

指定使用 TAPI 註冊傳真服務的控制碼。 如需詳細資訊,請參閱 TAPI 2.x lineInitializeEx 函 式。

[in] HeapHandle

類型: HANDLE

指定堆積的控制碼,FSP 必須用於所有記憶體配置。

[out] LineCallbackFunction

類型: PFAX_LINECALLBACK*

接收 TAPI 行回呼函式指標的變數指標。

[in] FaxServiceCallback

類型: PFAX_SERVICE_CALLBACK

服務回呼函式的指標。 雖然目前未使用此功能,但此功能預期在未來的傳真服務版本中可供使用,並提供從傳真服務到 FSP 的功能。

傳回值

類型: BOOL

如果函式成功,則傳回值是非零值。

如果此函式失敗,則傳回值為零。 在此情況下,傳真服務的目前實例不會使用此 FSP。 此 FSP 支援的所有裝置都無法傳送或接收傳真。 若要取得擴充的錯誤資訊,傳真服務會呼叫 GetLastError

備註

FSP 必須執行任何必要的初始化,以回應 FaxDevInitialize 函式。

FSP 必須提供LineCallbackFunction參數所指定的FaxLineCallback函式。 當傳真服務需要將 TAPI 事件傳遞至 FSP 時,會呼叫此函式。

需求

   
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 faxdev.h

另請參閱

傳真服務提供者函式

FaxDevStartJob

FaxDevVirtualDeviceCreation

FaxLineCallback

使用傳真服務提供者 API

lineInitializeEx