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 |