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呼び出すことによってバッファーを解放する必要があります。

必要条件

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

関連項目

wiasReadPropFloat を する

wiasReadPropGuid を する

wiasReadPropLong を する

wiasReadPropStr を する

wiasWritePropBin