传真服务调用 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。
备注
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 |