WIA_PROPERTY_CONTEXT 구조체(wiamindr_lh.h)

아티클
03/05/2024

WIA_PROPERTY_CONTEXT 구조체는 속성 식별자와 해당 컨텍스트를 저장합니다.

구문

typedef struct _WIA_PROPERTY_CONTEXT {
  ULONG  cProps;
  PROPID *pProps;
  BOOL   *pChanged;
} WIA_PROPERTY_CONTEXT, *PWIA_PROPERTY_CONTEXT;

멤버

cProps

이 구조체에 저장된 속성 식별자 수를 지정합니다.

pProps

작성 중인 속성을 나타내는 속성 식별자의 배열입니다.

pChanged

변경되는 속성을 나타내는 부울 값의 배열입니다. 이 배열의 멤버는 해당 속성이 변경되는 경우 TRUE 이고 해당 속성이 변경되지 않는 경우 FALSE 입니다. 즉, pChanged[n]이 TRUE이면 pProps[n]이 변경되고 pChanged[n]이 FALSE이면 pProps[n]이 변경되지 않습니다.

설명

부울 값은 IPropertyStorage::WriteMultiple을 호출하는 애플리케이션에 의해 해당 속성이 작성(변경)되는지 여부를 나타냅니다.

여러 WIA 서비스 라이브러리 함수는 WIA_PROPERTY_CONTEXT 구조를 사용합니다. wiasCreatePropContext 및 wiasFreePropContext 함수는 속성 컨텍스트를 만들거나 해제할 때 사용합니다. wiasIsPropChanged 및 wiasSetPropChanged는 이 구조를 사용하여 속성이 변경되었는지 여부를 확인하고 속성이 변경되면 속성 컨텍스트를 수정합니다. wiasGetChangedValueXxx 함수는 이 구조를 사용하여 특정 형식의 속성이 변경되었는지 여부를 확인합니다. wiasUpdateValidFormat 및 wiasUpdateScanRect는 각각 속성 컨텍스트를 업데이트하고 검색 디바이스의 검사 영역 크기를 업데이트하는 데 사용합니다.