PFAXDEVSEND

コールバック

シグネチャ

BOOL PFAXDEVSEND(
    HANDLE param0,
    FAX_SEND* param1,
    PFAX_SEND_CALLBACK param2
);

パラメーター

フィールド	型
param0	HANDLE
param1	FAX_SEND*
param2	PFAX_SEND_CALLBACK

公式ドキュメント

ファクスサービスは、送信ファクスの送信を開始する必要があることをファクスサービスプロバイダー (FSP) に通知するために、FaxDevSend 関数を呼び出します。各 FSP は FaxDevSend 関数をエクスポートする必要があります。

戻り値

型: BOOL

関数が成功すると、戻り値は 0 以外の値になります。

関数が失敗すると、戻り値は 0 になります。拡張エラー情報を取得するために、ファクスサービスは 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() はここに挙げたもの以外のコードを返す必要があります。

解説(Remarks)

FSP は、FaxDevSend 関数に応答して、発信を行い、データを送信し、呼び出しを終了させる必要があります。プロバイダーは、lineSetMediaMode 関数を呼び出して、呼び出しのメディアモードを正しく設定できます。ファクスサービスプロバイダーは、FAX_SEND 構造体の ReceiverNumber メンバーで指定された番号にダイヤルする必要があります。

FSP は、FaxDevSend 関数のコンテキストにある間は回線の所有権を持ち、すべてのプロトコル処理とエラー訂正を自ら処理する必要があります。

FAX_SEND 構造体の FileName メンバーで指定されたファイルに格納されているデータストリームは、Tagged Image File Format Class F (TIFF Class F) ファイルです。詳細については、ファクスの画像形式を参照してください。

呼び出しが確立したことをファクスサービスに通知するために、FSP は FaxSendCallback パラメーターが指す FaxSendCallback 関数を呼び出さなければなりません。このコールバック関数は、TAPI が割り当てる呼び出しハンドルもファクスサービスに提供します。このハンドルは TAPI のメッセージルーティングに必要です。FSP が FaxSendCallback を呼び出さない場合、その送信操作に関する呼び出し固有のイベントをすべて取り逃します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)