wiasSetItemPropAttribs 関数 (wiamdef.h)

wiasSetItemPropAttribs 関数は、アイテムのプロパティ セットのアクセス フラグと有効な値を設定します。

構文

HRESULT wiasSetItemPropAttribs(
  [in] BYTE               *pWiasContext,
       LONG               cPropSpec,
  [in] PROPSPEC           *pPropSpec,
  [in] PWIA_PROPERTY_INFO pwpi
);

パラメーター

[in] pWiasContext

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

cPropSpec

プロパティの数を指定します。

[in] pPropSpec

有効な値とアクセス フラグを設定するプロパティを示す PROPSPEC 構造体の配列の最初の要素 (Microsoft Windows SDK ドキュメントで定義) へのポインター。

[in] pwpi

書き込むプロパティ値を含む WIA_PROPERTY_INFO 構造体の配列の最初の要素へのポインター。

戻り値

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

備考

ミニドライバーは、この関数を使用して、単純なプロパティのグループを初期化する必要があります。 プロパティのグループには、ビットセット、値の範囲、または値のリストを指定できます。 サポートされている単純型は、属性別にグループ化されます。

属性	サポートされている型
WIA_PROP_FLAG	VT_UI1、VT_UI2、VT_UI4、VT_UI8、VT_I1、VT_I2、VT_I4、VT_I8
WIA_PROP_RANGE	VT_UI1、VT_UI2、VT_UI4、VT_UI8、VT_I1、VT_I2、VT_I4、VT_I8、VT_R4、VT_R8
WIA_PROP_LIST	VT_UI1、VT_UI2、VT_UI4、VT_UI8、VT_I1、VT_I2、VT_I4、VT_I8、VT_R4、VT_R8、VT_BSTR

ミニドライバーは、wiasSetPropertyAttributes 関数を使用して複合プロパティを初期化する必要があります。

ミニドライバーは、時間の経過と同時に変更されないプロパティにWIA_PROP_CACHEABLE フラグを設定できます。 プロパティにこのフラグを設定すると、ミニドライバーは、WIA サービスがプロパティ値をキャッシュできることを示します。 すべてのプロパティ属性の一覧については、Windows SDK のドキュメントを参照してください。

wiasSetItemPropAttribs はブール値ではなく HRESULT を返します。 たとえば、wiasSetItemPropAttribs 0 を返す場合、この値は FALSE ではなくS_OKとして解釈する必要があり、すべてが期待どおりに動作したことを示します。 wiasSetItemPropAttribs が HRESULT S_FALSEを返す場合は、設定しようとしているプロパティの 1 つがプロパティ ストリームに存在しない可能性があることを示します。

このエラーの wiadebug ログを取得するには、レジストリを開き、警告とエラーの WIA ログを有効にします。 このレジストリ キーは次のとおりです: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\StillImage\Debug\wiaservc.dll

"DebugFlags" の値を 0x00000003 に設定します。

システムを再起動し、このエラーを生成するために必要な手順を繰り返します。 これで、ディレクトリに "wiadebug.log" という名前のファイル %windir% 作成されます。

必要条件

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

関連項目

WIA_PROPERTY_INFO

wiasSetItemPropNames

wiasSetPropertyAttributes を する