FaxDevReceive 函式 (faxdev.h)

  • 發行項

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

語法

BOOL FaxDevReceive(
  [in]      HANDLE       FaxHandle,
  [in]      HCALL        CallHandle,
  [in, out] PFAX_RECEIVE FaxReceive
);

參數

[in] FaxHandle

類型： HANDLE

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

[in] CallHandle

類型： HCALL

指定 TAPI 呼叫控制碼。 請注意，FSP 應該針對所有呼叫作業使用此控制碼，但不應該關閉此控制碼。 如果 CallHandle 設定為 Null，服務會要求 FSP 開始接收傳真，而不會線上路上收到信號。 當您接聽電話時，可能會發生這種情況，然後發現它是傳真呼叫，或當您想要在現有的通話期間收到傳真， (傳真輪詢) 。 如果 FSP 不支援此選項，它應該會傳回錯誤。 如果 FSP 支援此選項，它應該會挑選裝置的線路並開始接收傳真。

[in, out] FaxReceive

類型： PFAX_RECEIVE

包含內送傳真檔相關資訊 之FAX_RECEIVE 結構的指標。 傳回時，結構也會包含 ReceiverName 和 ReceiverNumber 成員。

傳回值

類型： BOOL

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

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

備註

傳真服務會在與 FSP 通道相關聯的 TAPI 線路裝置之後呼叫 FaxDevReceive 函式，而該行處於 供應專案 狀態。 如需通話狀態的資訊，請參閱 TAPI 檔中 的狀態 。

FSP 必須藉由接收傳入傳真檔來回應 FaxDevReceive 函 式。 FSP 必須透過 TAPI 接受來電，然後接收傳真資料流程。 FSP 應該將資料流程儲存在傳遞至FaxDevReceive函式之FAX_RECEIVE結構的FileName成員所指定的檔案中。 此檔案是標記圖像檔案格式類別 F (TIFF 類別 F) 檔案。 如需詳細資訊，請參閱 傳真圖像格式。

FSP 應該在FaxReceive參數所指向的FAX_RECEIVE結構中設定ReceiverName 和 ReceiverNumber成員。 傳真服務會為這些字串配置記憶體。 服務配置的記憶體大小等於 sizeof (FAX_RECEIVE) + FAXDEVRECEIVE_SIZE。 FSP 必須將字串放在 FAX_RECEIVE結構的記憶體 區塊中。 ReceiverName和ReceiverNumber成員必須指向記憶體區塊中字串的位置。 如需說明如何填入傳真服務配置記憶體的程式碼範例和圖表，請參閱 FAX_RECEIVE。

注意如果 FSP 回報FS_USER_ABORT以外的任何擴充狀態，傳真服務會嘗試還原部分接收的傳真。 否則，傳真服務將會捨棄部分接收的傳真。
 

需求

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

另請參閱

FAX_RECEIVE

傳真服務提供者函式

FaxDevSend

FaxDevStartJob

使用傳真服務提供者 API