wiasGetImageInformation 関数 (wiamdef.h)

wiasGetImageInformation 関数は、アイテムから転送コンテキスト情報を取得します。

構文

HRESULT wiasGetImageInformation(
  [in]      BYTE                      *pWiasContext,
            LONG                      lFlags,
  [in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);

パラメーター

[in] pWiasContext

WIA 項目コンテキストへのポインター。

lFlags

操作フラグを指定します。 現時点では、次のフラグのみが定義されています。

旗	意味
WIAS_INIT_CONTEXT	MINIDRV_TRANSFER_CONTEXT構造体を初期化します。

[in, out] pmdtc

MINIDRV_TRANSFER_CONTEXT 構造体へのポインター。 戻ると、この構造体には要求されたイメージ項目情報が含まれます。

戻り値

成功すると、関数はS_OKを返します。

関数が失敗した場合は、標準の COM エラーまたは WIA エラー コードのいずれかが返されます。

備考

この関数では、MINIDRV_TRANSFER_CONTEXT 構造を使用して、項目の画像と項目ヘッダーのサイズを計算します。 さらに、イメージ形式にデータ ヘッダーが必要な場合は、必要に応じてイメージ ヘッダーを入力することもできます。 MINIDRV_TRANSFER_CONTEXT構造体の pTransferBuffer メンバーが NULL でない場合、ヘッダーはバッファーにコピーされます。 ヘッダーのない画像形式 (JPEG など) を使用する場合、MINIDRV_TRANSFER_CONTEXT構造体の lHeaderSize メンバーのヘッダー サイズは 0 として報告されます。

イメージの実際の最終的なサイズがデータ取得後まで認識されないイメージ形式の場合、マルチページ TIFF 形式や圧縮形式と同様に、MINIDRV_TRANSFER_CONTEXT 構造体の lItemSize メンバーはゼロとして報告されます。 lImageSize メンバーは、1 ページの圧縮されていないイメージのサイズ (バイト単位) として報告されます。

lFlags パラメーターでWIAS_INIT_CONTEXTが指定されている場合、pmdtc パラメーターが指すMINIDRV_TRANSFER_CONTEXT構造体には、アイテムのイメージ プロパティから派生した情報が入力されます。 このフラグは、ミニドライバーが新しいコンテキストを割り当てた場合に使用する必要があります。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	wiamdef.h (Wiamdef.h を含む)
ライブラリ	Wiaservc.lib
DLL	Wiaservc.dll

関連項目

MINIDRV_TRANSFER_CONTEXT