wiasReadPropBin 関数 (wiamdef.h)

  • [アーティクル]

wiasReadPropBin 関数は、WIA 項目からバイナリ データ プロパティ値を取得します。

構文

HRESULT wiasReadPropBin(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BYTE   **ppbVal,
  [out, optional] BYTE   **ppbValOld,
                  BOOL   bMustExist
);

パラメーター

[in] pWiasContext

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

propid

プロパティ識別子を指定します。

[out] ppbVal

この関数によって割り当てられたバッファーのアドレスを受け取るメモリ位置へのポインター。 返されると、バッファーにはプロパティのバイナリ データが含まれます。

[out, optional] ppbValOld

ミニドライバーによって割り当てられたバッファーのアドレスを受け取るメモリの場所へのポインター。 返されると、バッファーにはプロパティのバイナリ データの以前の値が含まれます。 この情報が必要ない場合は、このパラメーターを NULL に設定できます。

bMustExist

プロパティが存在する必要があるかどうかを示します。 TRUE に設定する場合は、 プロパティが存在する必要があります。FALSE に設定されている場合、プロパティは存在する必要はありません。

戻り値

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

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

注釈

この関数はバッファーを割り当て、そのアドレスを ppbVal パラメーターに格納します。 ミニドライバーは 、CoTaskMemFree を呼び出してバッファーを解放する必要があります。

要件

要件 値
対象プラットフォーム デスクトップ
Header wiamdef.h (Wiamdef.h を含む)
Library Wiaservc.lib
[DLL] Wiaservc.dll

こちらもご覧ください

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasReadPropStr

wiasWritePropBin