wiasIsPropChanged 関数 (wiamdef.h)

[アーティクル]
03/08/2024

wiasIsPropChanged 関数は、指定したプロパティがアプリケーションによって変更されたかどうかをテストします。

構文

HRESULT wiasIsPropChanged(
        PROPID               propid,
  [in]  WIA_PROPERTY_CONTEXT *pContext,
  [out] BOOL                 *pbChanged
);

パラメーター

propid

チェックするプロパティのプロパティ識別子を指定します。

[in] pContext

現在のプロパティコンテキストを含む WIA_PROPERTY_CONTEXT 構造体へのポインター。

[out] pbChanged

BOOL 値を受け取るメモリ位置へのポインター。プロパティが変更された場合は BOOL 値が TRUE 、プロパティが変更されなかった場合は FALSE です。

戻り値

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

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

注釈

この関数は、プロパティの WIA_PROPERTY_CONTEXT 構造体の bChanged メンバー値を調べることで、プロパティが変更されているかどうかを判断します。ミニドライバーは通常、この関数を使用して、依存するプロパティを更新できるように、独立したプロパティが変更されたときにチェックします。