wiasSetItemPropAttribs 関数 (wiamdef.h)

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

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 に設定します。

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