wiasSetPropChanged 関数 (wiamdef.h)

wiasSetPropChanged 関数は、プロパティが変更されていることを示すようにプロパティ コンテキストを変更します。

構文

HRESULT wiasSetPropChanged(
       PROPID               propid,
  [in] WIA_PROPERTY_CONTEXT *pContext,
       BOOL                 bChanged
);

パラメーター

propid

変更するプロパティのプロパティ識別子を指定します。

[in] pContext

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

bChanged

WIA_PROPERTY_CONTEXT構造体の pChanged メンバーによって指される配列内の特定の要素を設定するために使用される BOOL 値を指定します。 詳細については、「解説」セクションを参照してください。

戻り値

成功すると、関数はS_OKを返します。 関数が失敗すると、標準の COM エラーまたは WIA_ERROR_XXX エラーのいずれかが返されます (Microsoft Windows SDK のドキュメントで説明)。

備考

WIA_PROPERTY_CONTEXT 構造体の pChanged メンバーは、特定のプロパティが変更されるかどうかを示す BOOL 値の配列を指します。 この関数は、その配列内の 1 つの要素をプロパティ コンテキスト内の指定されたプロパティに設定します。 この関数は、ドライバーが検証で依存プロパティを持つプロパティを変更するたびに使用する必要があります。 たとえば、"現在の意図" を変更すると、"水平解像度" が変更され、"X Resolution" (WIA_IPS_XRES) とその依存の検証が引き続き行われるように、変更済みとしてマークする必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Microsoft Windows Me および Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。
ターゲット プラットフォーム の	デスクトップ
ヘッダー	wiamdef.h (Wiamdef.h を含む)
ライブラリ	Wiaservc.lib
DLL	Wiaservc.dll

関連項目

WIA_PROPERTY_CONTEXT

wiasIsPropChanged の