MAPPING_OPTIONS 構造体 (elscore.h)

  • [アーティクル]

テキスト認識のオプションが含まれています。 この構造体に格納されている値は、 MappingRecognizeText の動作と結果に影響します。

構文

typedef struct _MAPPING_OPTIONS {
  size_t                  Size;
  LPWSTR                  pszInputLanguage;
  LPWSTR                  pszOutputLanguage;
  LPWSTR                  pszInputScript;
  LPWSTR                  pszOutputScript;
  LPWSTR                  pszInputContentType;
  LPWSTR                  pszOutputContentType;
  LPWSTR                  pszUILanguage;
  PFN_MAPPINGCALLBACKPROC pfnRecognizeCallback;
  LPVOID                  pRecognizeCallerData;
  DWORD                   dwRecognizeCallerDataSize;
  PFN_MAPPINGCALLBACKPROC pfnActionCallback;
  LPVOID                  pActionCallerData;
  DWORD                   dwActionCallerDataSize;
  DWORD                   dwServiceFlag;
  unsigned                GetActionDisplayName : 1;
} MAPPING_OPTIONS, *PMAPPING_OPTIONS;

メンバー

Size

構造体のバージョンを検証するために使用される構造体のサイズ。 この値は必須です。

pszInputLanguage

任意。 サービスで受け入れられる入力言語を識別する IETF 名前付け規則に従う入力言語文字列へのポインター。 アプリケーションは、このメンバーを NULL に設定して、サービスが入力をサポートする任意の入力言語として自由に解釈できることを示すことができます。

pszOutputLanguage

省略可能。 結果を生成するためにサービスで使用できる出力言語を識別する、IETF の名前付け規則に従う出力言語文字列へのポインター。 サービスが出力言語を決定する必要がある場合、アプリケーションはこのメンバーを NULL に設定できます。

pszInputScript

任意。 サービスで受け入れる必要がある標準の Unicode スクリプト名へのポインター。 アプリケーションでは、このメンバーを NULL に設定して、サービスが入力の処理方法を決定できるようにします。

pszOutputScript

省略可能。 サービスが結果を取得するために使用する標準の Unicode スクリプト名へのポインター。 アプリケーションでは、このメンバーを NULL に設定して、サービスが出力スクリプトを決定できるようにします。

pszInputContentType

省略可能。 MIME コンテンツ タイプの形式に従って、アプリケーションがデータを渡すときにサービスが解釈できる形式を識別する文字列へのポインター。 コンテンツ タイプの例としては、"text/plain"、"text/html"、"text/css" があります。 アプリケーションでは、このメンバーを NULL に設定して、"text/plain" コンテンツ タイプを示すことができます。

メモ Windows 7 では、ELS サービスはコンテンツ タイプ "text/plain" のみをサポートします。 コンテンツ タイプの仕様は、「 テキスト メディアの種類」を参照してください。
 

pszOutputContentType

任意。 サービスがデータを取得する形式を識別する MIME コンテンツ タイプの形式に従う文字列へのポインター。 アプリケーションでは、このメンバーを NULL に設定して、サービスが出力コンテンツ タイプを決定できるようにします。

pszUILanguage

予約済み。

pfnRecognizeCallback

省略可能。 MappingRecognizeText 関数の結果を含むコールバックを受け取るアプリケーション コールバック関数へのポインター。 コールバック関数が指定されている場合、テキスト認識は非同期モードで実行され、アプリケーションはコールバック関数を介して結果を取得します。 テキスト認識を同期する場合は、アプリケーションでこのメンバーを NULL に設定する必要があります。

pRecognizeCallerData

省略可能。 テキスト認識が完了した後、サービスによってコールバック関数に渡されるプライベート アプリケーション データへのポインター。 プライベート アプリケーション データがないことを示すには、アプリケーションでこのメンバーを NULL に設定する必要があります。

dwRecognizeCallerDataSize

省略可能。 pRecognizeCallerData メンバーによって示されるプライベート アプリケーション データのサイズ (バイト単位)。

pfnActionCallback

予約済み。

pActionCallerData

予約済み。

dwActionCallerDataSize

予約済み。

dwServiceFlag

省略可能。 サービスの動作に影響を与えるためにサービス プロバイダーが定義するプライベート フラグ。 サービスは、必要に応じてこのフラグを解釈できます。

メモ Windows 7 の場合、使用可能な ELS サービスではフラグはサポートされません。
 

GetActionDisplayName

予約済み。

解説

サービスは NULL メンバーを既定値として扱うので、アプリケーションはこの構造体のすべてのメンバーを入力する必要はありません。 未使用のメンバーはすべて 0 に設定する必要があります。

警告 この構造体で MappingRecognizeText に渡されるデータと、その呼び出しで pszText 引数によって参照されるデータ。

pBag によって渡されたプロパティ バッグ構造が を介して解放されるまで、有効なままである必要があります

MappingFreePropertyBag。 これは、同期呼び出しと非同期呼び出しの両方が に対して行われるためです。

MappingRecognizeText と MappingDoAction は、初期に渡されたデータの使用を試みます

MappingRecognizeText を呼び出します。

 

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
Header elscore.h

関連項目

拡張言語サービスの構造

MAPPING_DATA_RANGE

MappingRecognizeText