共用方式為


FaxDevSend 函式 (faxdev.h)

傳真服務會呼叫 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

另請參閱

FAX_SEND

傳真服務提供者函式

FaxDevReceive

FaxDevStartJob

FaxSendCallback

使用傳真服務提供者 API