IWiaMiniDrv::d rvGetWiaFormatInfo メソッド (wiamindr_lh.h)

IWiaMiniDrv::d rvGetWiaFormatInfo メソッドは、WIA ハードウェア デバイスがサポートするイメージ形式とメディアの種類を検索します。

構文

HRESULT drvGetWiaFormatInfo(
  BYTE            *__MIDL__IWiaMiniDrv0059,
  LONG            __MIDL__IWiaMiniDrv0060,
  LONG            *__MIDL__IWiaMiniDrv0061,
  WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
  LONG            *__MIDL__IWiaMiniDrv0063
);

パラメーター

__MIDL__IWiaMiniDrv0059

lFlags [in]

予約済み。

__MIDL__IWiaMiniDrv0060

pWiasContext [in]

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

__MIDL__IWiaMiniDrv0061

pcelt [out]

ppwfi が指す配列内の項目数を受け取るメモリ位置を指します。

__MIDL__IWiaMiniDrv0062

plDevErrVal [out]

このメソッドの状態コードを受け取るメモリの場所を指します。 このメソッドがS_OKを返す場合、格納される値は 0 になります。 それ以外の場合、ミニドライバー固有のエラー コードは、このパラメーターが指す場所に格納されます。

__MIDL__IWiaMiniDrv0063

ppwfi [out, optional]

WIA_FORMAT_INFO構造体の配列の最初の要素のアドレスを受け取るメモリ位置 を 指します。

戻り値

成功した場合、メソッドは S_OK を返し、 plDevErrVal が指すデバイス エラー値をクリアする必要があります。 データを含まないアイテムに対してこのメソッドが呼び出された場合は、 E_INVALIDARGを返す必要があります。 メソッドが失敗した場合は、標準の COM エラー コードを返し、 plDevErrVal が指すメモリにミニドライバー固有のエラー コード値を配置する必要があります。

plDevErrVal が指す値は、IWiaMiniDrv::d rvGetDeviceErrorStr を呼び出すことによって文字列に変換できます。

注釈

このメソッドは、WIA ハードウェア デバイスがサポートする メディアの種類 とイメージ形式を記述するWIA_FORMAT_INFO構造体の配列を作成します。 配列内の各要素について、メディアの種類は、TYMED_CALLBACK、TYMED_MULTIPAGE_CALLBACK、TYMED_FILE、またはTYMED_MULTIPAGE_FILEのいずれかになります。 イメージ形式の一般的な値には、WiaImgFmt_JPEGやWiaImgFmt_BMPなどがあります。 詳細については、「 TYMED と WIA_IPA_FILENAME_EXTENSIONについて」を参照してください。

ミニドライバーは、 WIA_FORMAT_INFO 構造体を保持するグローバル配列を定義することも、配列にメモリを割り当てることもできます。 WIA サービスは割り当てられたメモリを解放しないため、ミニドライバーはドライバー項目コンテキストでそのメモリへのポインターを格納する必要があります。 ミニドライバーは、 IWiaMiniDrv::d rvFreeDrvItemContext の呼び出しでこのメモリを解放できます。

要件

こちらもご覧ください

IWiaMiniDrv

IWiaMiniDrv::d rvFreeDrvItemContext

IWiaMiniDrv::d rvGetDeviceErrorStr