FaxDevSend 函式 (faxdev.h)

發行項
08/23/2023

傳真服務會呼叫 FaxDevSend 函式，以向傳真服務提供者發出 (FSP) 必須起始傳出傳真傳輸的訊號。每個 FSP 都必須匯出 FaxDevSend 函式。

語法

BOOL FaxDevSend(
  [in] HANDLE             FaxHandle,
  [in] PFAX_SEND          FaxSend,
       PFAX_SEND_CALLBACK FaxSendCallback
);

參數

[in] FaxHandle

類型： HANDLE

指定 FaxDevStartJob 函式所傳回的傳真控制碼。

[in] FaxSend

類型： PFAX_SEND

包含傳送資訊的 FAX_SEND 結構的指標。如需詳細資訊，請參閱接下來的＜備註＞一節。

FaxSendCallback

類型： PFAX_SEND_CALLBACK

回呼函式的指標，該函式會通知 TAPI 所指派之呼叫控制碼的傳真服務。如需詳細資訊，請參閱接下來的＜備註＞一節。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得延伸的錯誤資訊，傳真服務會呼叫 GetLastError。

注意若要成功傳送，FaxDevSend () 應該會傳回 TRUE ，而 FaxDevReportStatus () 應該傳回FS_COMPLETED。若傳送失敗，FaxDevSend () 應該傳回 FALSE，而 FaxDevReportStatus () 應該傳回下列任何代碼：FS_LINE_UNAVAILABLE、FS_NO_ANSWER、FS_NO_DIAL_TONE、FS_DISCONNECTED、FS_BUSY、FS_NOT_FAX_CALL或FS_FATAL_ERROR。如果在傳真失敗之後，不應重新傳送傳真，則 FaxDevReportStatus () 應該傳回此處所列以外的任何程式碼。

備註

FSP 必須透過呼叫、傳送資料，以及結束通話來回應 FaxDevSend 函式。提供者可以呼叫 lineSetMediaMode 函式，以正確設定呼叫的媒體模式。傳真服務提供者必須撥FAX_SEND結構之ReceiverNumber成員指定的號碼。

FSP 在 FaxDevSend 函式的內容中擁有該行的擁有權，而且必須處理所有通訊協定和錯誤更正。

儲存在FAX_SEND結構的FileName成員所指定的檔案中的資料流程是標記影像檔案格式類別 F (TIFF 類別 F) 檔案。如需詳細資訊，請參閱傳真影像格式。

若要通知傳真服務已建立通話，FSP 必須呼叫 FaxSendCallback 參數所指向的 FaxSendCallback函式。回呼函式也會提供傳真服務，以及 TAPI 指派的呼叫控制碼。 TAPI 訊息路由需要此控制碼。如果 FSP 未呼叫 FaxSendCallback，它會遺漏傳送作業的所有呼叫特定事件。

需求


最低支援的用戶端	Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	faxdev.h