wiasGetImageInformation 関数 (wiamdef.h)

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

構文

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

パラメーター

[in] pWiasContext

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

lFlags

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

[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 メンバーは 0 として報告されます。 lImageSize メンバーは、1 ページの圧縮されていないイメージのサイズ (バイト単位) として報告されます。

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

要件

こちらもご覧ください

MINIDRV_TRANSFER_CONTEXT