다음을 통해 공유

WIA 드라이버 서비스 라이브러리

  • 아티클

WIA 드라이버 서비스 라이브러리에는 WIA 미니드라이버가 다음 작업을 수행하는 데 도움을 요청할 수 있는 함수가 포함되어 있습니다.

WIA 미니드라이버가 필요에 따라 IWiaMiniDrv 인터페이스 메서드에서 이러한 함수의 대부분을 호출합니다. 그러나 각 WIA 미니드라이버는 IWiaMiniDrv::d rvInitializeWia 메서드에서 wiasCreateDrvItem 함수를 호출하여 드라이버 항목을 만들어야 합니다. wiasCreateDrvItem 함수를 성공적으로 호출할 때마다 미니드라이버의 항목 트리에 사용되는 IWiaDrvItem 항목 개체가 만들어집니다. 여러 IWiaDrvItem 인터페이스 메서드에는 IWiaDrvItem::AddItemToFolder, IWiaDrvItem::GetFirstChildItem, IWiaDrvItem::GetNextSiblingItem 및 IWiaDrvItem::GetParentItem을 포함하여 IWiaDrvItem 형식의 매개 변수가 있습니다. 또한 wiasGetDrvItem 함수에는 이 형식의 매개 변수가 있습니다.

드라이버 서비스 라이브러리는 다음 함수를 제공합니다.

항목 트리 빌드 및 유지 관리

함수 Description
wiasCreateChildAppItem 새 애플리케이션 항목을 만들고 지정된(부모) 항목의 자식으로 삽입합니다.
wiasCreateDrvItem IWiaDrvItem 개체를 만듭니다.
wiasGetChildrenContexts 현재 항목의 자식에 속하는 항목 컨텍스트의 배열을 검색합니다.
wiasGetContextFromName 항목 이름의 항목 컨텍스트를 검색합니다.
wiasGetDrvItem 드라이버 항목을 검색합니다.
wiasGetRootItem 지정된 WIA 항목의 루트 항목 컨텍스트를 검색합니다.

로그 오류 및 추적 메시지

함수 Description
wiasCreateLogInstance 로깅 개체의 instance 만듭니다.
wiasDebugError 장치 관리자 디버그 콘솔에서 디버그 오류 문자열을 인쇄합니다. 출력 색은 항상 빨간색입니다. 이 함수는 호환성을 위해서만 제공됩니다. 대신 WIAS_ERROR 사용하는 것이 좋습니다.
wiasDebugTrace 장치 관리자 디버그 콘솔에서 디버그 추적 문자열을 인쇄합니다. 이 함수는 호환성을 위해서만 제공됩니다. 대신 WIA_TRACE 사용하는 것이 좋습니다.
wiasFormatArgs 로깅을 위해 인수 목록의 형식을 패키지된 문자열로 지정합니다.
wiasPrintDebugHResult 장치 관리자 디버그 콘솔에 HRESULT 문자열을 인쇄합니다. 이 함수는 호환성을 위해서만 제공됩니다. 사용되지 않으며 더 이상 지원되지 않습니다. 대신 WIAS_LHRESULT 사용합니다.

항목 속성 읽기 및 저장

함수 Description
wiasCreatePropContext 변경 중인 항목의 속성을 나타내는 속성 컨텍스트를 할당합니다.
wiasFreePropContext WIA_PROPERTY_CONTEXT 구조체에서 차지하는 메모리를 해제합니다.
wiasGetChangedValueFloat 부동 소수점 값이 있는 속성이 애플리케이션에서 변경되었는지 여부를 확인합니다.
wiasGetChangedValueGuid GUID 값이 있는 속성이 애플리케이션에서 변경되었는지 여부를 확인합니다.
wiasGetChangedValueLong 정수 값이 긴 속성이 애플리케이션에서 변경되었는지 여부를 확인합니다.
wiasGetChangedValueStr 문자열 값이 있는 속성이 애플리케이션에서 변경되었는지 여부를 확인합니다.
wiasGetItemType 루트 또는 자식 항목을 나타냅니다.
wiasGetPropertyAttributes 속성 집합에 대한 액세스 플래그 및 유효한 값을 검색합니다.
wiasIsPropChanged 지정된 속성이 애플리케이션에 의해 변경되었는지 여부를 테스트합니다.
wiasReadMultiple WIA 항목에서 여러 속성을 읽습니다.
wiasReadPropBin WIA 항목에서 단일 이진 속성을 읽습니다.
wiasReadPropFloat WIA 항목에서 부동 소수점 속성 값을 검색합니다.
wiasReadPropGuid WIA 항목에서 GUID 속성 값을 검색합니다.
wiasReadPropLong WIA 항목에서 긴 정수 속성 값을 검색합니다.
wiasReadPropStr WIA 항목에서 문자열 속성 값을 검색합니다.
wiasSetItemPropAttribs 항목의 속성 집합에 대한 액세스 플래그 및 유효한 값을 설정합니다.
wiasSetItemPropNames 항목 속성에 속성 이름을 씁니다.
wiasSetPropChanged 속성 컨텍스트를 수정하여 속성이 변경되고 있음을 나타냅니다.
wiasSetPropertyAttributes 항목 속성의 액세스 플래그 및 속성 값을 설정합니다.
wiasSetValidFlag WIA_PROP_FLAG 속성에 유효한 값을 설정합니다.
wiasSetValidListFloat 하위 VT_R4 형식의 WIA_PROP_LIST 속성에 유효한 값을 설정합니다.
wiasSetValidListGuid 하위 형식 VT_CLSID WIA_PROP_LIST 속성에 유효한 값을 설정합니다.
wiasSetValidListLong 하위 VT_I4 형식의 WIA_PROP_LIST 속성에 유효한 값을 설정합니다.
wiasSetValidListStr 하위 VT_BSTR 형식의 WIA_PROP_LIST 속성에 유효한 값을 설정합니다.
wiasSetValidRangeFloat 하위 형식 VT_R4 WIA_PROP_RANGE 속성에 유효한 값의 범위를 지정합니다.
wiasSetValidRangeLong 하위 형식 VT_I4 WIA_PROP_RANGE 속성에 유효한 값의 범위를 지정합니다.
wiasUpdateValidFormat 현재 미니 드라이버에 대한 속성 컨텍스트의 유효한 형식을 업데이트.
wiasValidateItemProperties 현재 유효한 값에 대해 단순 항목 속성 목록의 유효성을 검사합니다.
wiasWriteMultiple WIA 항목에 여러 속성 값을 씁니다(속성은 다른 형식일 수 있음).
wiasWritePropBin WIA 항목에 단일 이진 속성 값을 씁니다.
wiasWritePropFloat 부동 소수점 속성 값을 WIA 항목에 씁니다.
wiasWritePropGuid GUID 속성 값을 WIA 항목에 씁니다.
wiasWritePropLong 긴 정수 속성 값을 WIA 항목에 씁니다.
wiasWritePropStr WIA 항목에 문자열 속성 값을 씁니다.

데이터 업데이트 및 전송

함수 Description
wiasDownSampleBuffer 픽셀 데이터의 버퍼를 가져와서 지정된 크기로 다운샘플링합니다.
wiasGetImageInformation 항목에서 전송 컨텍스트 정보를 검색합니다.
wiasParseEndorserString 보증자 문자열을 구문 분석하여 문자열의 WIA 서비스 정의 및 공급업체 정의 토큰을 토큰과 연결된 값으로 바꿉니다.
wiasSendEndOfPage 데이터 전송 중에 클라이언트 콜백 루틴을 호출하여 현재 총 페이지 수를 보냅니다.
wiasUpdateScanRect 검색 디바이스의 검사 영역 크기를 업데이트.
wiasWriteBufToFile 임시 페이지 버퍼의 내용을 이미지 파일에 씁니다.
wiasWritePageBufToFile 임시 페이지 버퍼의 내용을 이미지 파일에 씁니다. 이 함수를 사용하여 여러 페이지 TIFF 파일에 페이지를 작성합니다.