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"이라는 파일이 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 데스크톱 |
머리글 | wiamdef.h(Wiamdef.h 포함) |
라이브러리 | Wiaservc.lib |
DLL | Wiaservc.dll |