wiasCreatePropContext 함수(wiamdef.h)
wiasCreatePropContext 함수는 속성 컨텍스트를 할당하여 애플리케이션에서 변경되는 항목의 속성을 나타냅니다.
구문
HRESULT wiasCreatePropContext(
ULONG cPropSpec,
[in] PROPSPEC *pPropSpec,
ULONG cProps,
[in, optional] PROPID *pProps,
[in] WIA_PROPERTY_CONTEXT *pContext
);
매개 변수
cPropSpec
pPropSpec 배열의 PROPSPEC 구조체의 총 수를 지정합니다.
[in] pPropSpec
변경되는 속성을 식별하는 PROPSPEC 구조체 배열의 첫 번째 요소에 대한 포인터입니다.
cProps
이 컨텍스트에 저장된 속성 식별자 수를 지정합니다.
[in, optional] pProps
이 속성 컨텍스트에 넣을 속성을 나타내는 속성 식별자 배열의 첫 번째 요소에 대한 포인터입니다.
[in] pContext
속성 컨텍스트를 포함하는 WIA_PROPERTY_CONTEXT 구조체에 대한 포인터입니다.
반환 값
성공하면 함수는 S_OK 반환합니다. 함수가 실패하면 표준 COM 오류 또는 WIA 오류 코드 중 하나가 반환됩니다.
설명
이 함수는 속성 컨텍스트를 할당하고 해당 값을 채웁니다. 이 함수는 일반적으로 애플리케이션에서 작성한 속성의 유효성이 검사되는 wiasValidateItemProperties 에서 사용됩니다.
속성 컨텍스트의 항목은 종속성이 있거나 다른 속성에 종속된 속성의 식별자입니다. 컨텍스트는 변경되는 속성을 표시하는 데 사용됩니다. 속성 컨텍스트가 더 이상 필요하지 않은 경우 wiasFreePropContext를 호출하여 해제해야 합니다.
애플리케이션이 쓰는 속성은 pPropSpec 배열에 의해 지정됩니다. 애플리케이션에서 변경한 속성과 변경된 속성에 종속된 속성은 pProps 배열에 의해 지정됩니다. 애플리케이션(및 종속 속성)에 의해 변경된 속성만 pProps로 지정할 수 있습니다.
자세한 내용은 PROPSPEC 구조를 참조하세요.
드라이버는 wiasCreatePropContext를 사용하여 속성 컨텍스트를 만들 때 추가 속성을 지정할 수 있습니다.
다음 속성은 항상 WIA_PROPERTY_CONTEXT 있습니다.
WIA_IPA_DATATYPE
WIA_IPA_DEPTH
WIA_IPS_XRES
WIA_IPS_XPOS
WIA_IPS_XEXTENT
WIA_IPA_PIXELS_PER_LINE
WIA_IPS_YRES
WIA_IPS_YPOS
WIA_IPS_YEXTENT
WIA_IPA_NUMBER_OF_LINES
WIA_IPS_CUR_INTENT
WIA_IPA_TYMED
WIA_IPA_FORMAT
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wiamdef.h(Wiamdef.h 포함) |
| 라이브러리 | Wiaservc.lib |
| DLL | Wiaservc.dll |