FAX サービスは FaxDevSend 関数を呼び出して、FAX サービス プロバイダー (FSP) に送信 FAX 送信を開始する必要があることを通知します。 各 FSP は FaxDevSend 関数をエクスポートする必要があります。
構文
BOOL FaxDevSend(
[in] HANDLE FaxHandle,
[in] PFAX_SEND FaxSend,
PFAX_SEND_CALLBACK FaxSendCallback
);
パラメーター
[in] FaxHandle
型: HANDLE
FaxDevStartJob 関数によって返される FAX ハンドルを指定します。
[in] FaxSend
種類: PFAX_SEND
送信情報を含む FAX_SEND 構造体へのポインター。 詳細については、「解説」を参照してください。
FaxSendCallback
種類: PFAX_SEND_CALLBACK
TAPI が割り当てる呼び出しハンドルを FAX サービスに通知するコールバック関数へのポインター。 詳細については、「解説」を参照してください。
戻り値
種類: BOOL
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 拡張エラー情報を取得するために、FAX サービスは 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。 失敗した FAX の後に FAX を再送信しない場合、FaxDevReportStatus() はここに記載されているコード以外のコードを返す必要があります。
解説
FSP は、呼び出しを行い、データを送信し、呼び出しを終了することで、 FaxDevSend 関数に応答する必要があります。 プロバイダーは lineSetMediaMode 関数を呼び出して、呼び出しのメディア モードを正しく設定できます。 FAX サービス プロバイダーは、FAX_SEND構造体の ReceiverNumber メンバーによって指定された番号をダイヤルする必要があります。
FSP は FaxDevSend 関数のコンテキストで行の所有権を持ち、すべてのプロトコルとエラー修正を処理する必要があります。
FAX_SEND構造体の FileName メンバーによって指定されたファイルに格納されているデータ ストリームは、タグ付けされたイメージ ファイル形式クラス F (TIFF クラス F) ファイルです。 詳細については、「 FAX イメージの形式」を参照してください。
呼び出しが確立されたことを FAX サービスに通知するには、FSP は FaxSendCallback パラメーターが指す FaxSendCallback 関数を呼び出す必要があります。 コールバック関数は、TAPI が割り当てる呼び出しハンドルを FAX サービスにも提供します。 このハンドルは TAPI メッセージ ルーティングに必要です。 FSP が FaxSendCallback を呼び出さない場合、送信操作のすべての呼び出し固有のイベントが見つかりません。
要件
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | faxdev.h |