wiasSetItemPropAttribs 함수(wiamdef.h)

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

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

"DebugFlags" 값을 0x00000003

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