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 반환하는 경우 설정하려는 속성 중 하나가 속성 스트림에 없을 수 있음을 나타냅니다.

이 오류의 wiadebug 로그를 얻으려면 레지스트리를 열고 경고 및 오류에 대한 WIA 로깅을 켭니다. 레지스트리 키는 다음과 같습니다.HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\StillImage\Debug\wiaservc.dll

"DebugFlags" 값을 설정합니다. 0x00000003

시스템을 다시 부팅하고 이 오류를 생성하는 데 필요한 단계를 반복합니다. 이제 %windir% 디렉터리에 "wiadebug.log"라는 파일이 있습니다.

요구 사항

지원되는 최소 클라이언트	Microsoft Windows Me 및 Windows XP 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
헤더	wiamdef.h(Wiamdef.h 포함)
라이브러리	Wiaservc.lib
DLL	Wiaservc.dll

참고 항목

WIA_PROPERTY_INFO

wiasSetItemPropNames

wiasSetPropertyAttributes