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