ホーム › Globalization › PFN_MAPPINGCALLBACKPROC

PFN_MAPPINGCALLBACKPROC

コールバック

シグネチャ

void PFN_MAPPINGCALLBACKPROC(
    MAPPING_PROPERTY_BAG* pBag,
    void* data,
    DWORD dwDataSize,
    HRESULT Result
);

パラメーター

フィールド	型	説明
pBag	MAPPING_PROPERTY_BAG*	MappingRecognizeText の呼び出し結果を格納した MAPPING_PROPERTY_BAG 構造体へのポインターです。
data	void*	アプリケーション独自のプライベートデータへのポインターです。このポインターは、MAPPING_OPTIONS 構造体の pRecognizeCallerData メンバーで渡したものと同じです。
dwDataSize	DWORD	プライベートなアプリケーションデータのサイズ (バイト単位)。このサイズは、アプリケーションが MappingRecognizeText を非同期に呼び出したときに MAPPING_OPTIONS 構造体の dwRecognizeCallerDataSize メンバーで渡したサイズと同じです。
Result	HRESULT	MappingRecognizeText からの戻りコードです。関数が成功した場合は S_OK、それ以外の場合はエラーコードになります。

公式ドキュメント

MappingRecognizeText 関数が生成したデータを非同期に処理する、アプリケーション定義のコールバック関数です。MAPPINGCALLBACKPROC 型は、このコールバック関数へのポインターを定義します。MappingCallbackProc は、アプリケーション定義の関数名のプレースホルダーです。

解説(Remarks)

MappingCallbackProc 関数は、MappingRecognizeText が取得した結果を処理します。アプリケーションは、このコールバック関数のアドレスを MAPPING_OPTIONS 構造体に格納して MappingRecognizeText に渡すことで、コールバック関数を登録します。

アプリケーションは、pBag パラメーターのデータを使用する前に Result パラメーターを確認してください。プロパティバッグのデータの使用が終わったら、アプリケーションは必ず MappingFreePropertyBag を呼び出す必要があります。プロパティバッグには元のテキストへのポインターが含まれている可能性があるためです。プロパティバッグの詳細については、MAPPING_PROPERTY_BAG 構造体の解説を参照してください。

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