PFAXDEVRECEIVE

コールバック

シグネチャ

BOOL PFAXDEVRECEIVE(
    HANDLE param0,
    DWORD param1,
    FAX_RECEIVE* param2
);

パラメーター

フィールド	型
param0	HANDLE
param1	DWORD
param2	FAX_RECEIVE*

公式ドキュメント

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

戻り値

型: BOOL

関数が成功した場合、戻り値は 0 以外の値です。

関数が失敗した場合、戻り値は 0 です。拡張エラー情報を取得するには、ファクスサービスが GetLastError を呼び出します。

解説(Remarks)

ファクスサービスは、FSP に関連付けられた TAPI 回線デバイスが着信し、回線が offering 状態になった後に FaxDevReceive 関数を呼び出します。通話の状態については、TAPI のドキュメントの状態を参照してください。

FSP は、着信するファクス文書を受信することで FaxDevReceive 関数に応答する必要があります。FSP は TAPI を通じて着信呼び出しを受け入れ、その後ファクスのデータストリームを受信する必要があります。FSP は、FaxDevReceive 関数に渡される FAX_RECEIVE 構造体の FileName メンバーで指定されたファイルに、そのデータストリームを格納してください。このファイルは Tagged Image File Format Class F (TIFF Class F) 形式のファイルです。詳細については、ファクスの画像形式を参照してください。

FSP は、FaxReceive パラメーターが指す FAX_RECEIVE 構造体の ReceiverName メンバーと ReceiverNumber メンバーを設定してください。これらの文字列用のメモリーはファクスサービスが割り当てます。サービスが割り当てるメモリーのサイズは sizeof(FAX_RECEIVE) + FAXDEVRECEIVE_SIZE です。FSP は、FAX_RECEIVE 構造体に続くメモリーブロック内に文字列を配置する必要があります。ReceiverName メンバーと ReceiverNumber メンバーは、メモリーブロック内の文字列の位置を指している必要があります。ファクスサービスが割り当てたメモリーを埋める方法を示すコードサンプルと図については、FAX_RECEIVE を参照してください。

注意 FSP が FS_USER_ABORT 以外の拡張ステータスを報告した場合、ファクスサービスは部分的に受信したファクスの復元を試みます。それ以外の場合、ファクスサービスは部分的に受信したファクスを破棄します。

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