Share via


스캐너 디바이스 속성 상수

WIA(Windows Image Acquisition) 하드웨어 디바이스에는 Windows 레지스트리에 저장된 속성 값이 있습니다. 자세한 내용은 일반적인 디바이스 속성 상수를 참조하세요. 연결된 문자열을 사용하는 다음 디바이스 속성 상수는 디지털 이미지 스캐너와 관련이 있습니다.

접두사 "WIA_DPS_"는 스캐너 디바이스에 대한 Device Property를 나타내며 C/C++에서 사용되는 명명 규칙입니다. 스크립팅을 위해 이러한 상수는 접두사 "ScannerDevice"를 사용하며 WiaItemPropertyId 열거형 형식의 일부입니다. 해당 스크립트 열거형의 해당 멤버 이름은 다음 목록의 C/C++ 상수 이름 옆에 괄호로 표시됩니다.

상수/값 설명
WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId
참고:
이 속성은 Windows Vista 이상에서만 지원됩니다.


웹 서비스 스캐너 디바이스에 대한 고유한 함수 instance 식별자를 포함합니다. 이 식별자는 WIA 미니 드라이버가 통신하는 스캐너 디바이스의 웹 서비스를 나타냅니다. 이 식별자의 형식에 대한 가정은 수행해서는 안 됩니다. WIA 미니 드라이버는 이 속성을 만들고 유지 관리합니다.
WIA 애플리케이션은 WIA_DPS_DEVICE_ID 값을 사용하여 함수 검색 API를 사용하여 현재 WIA 2.0 세션에서 사용되는 웹 서비스 스캐너 디바이스를 나타내는 함수 instance 개체를 찾을 수 있습니다.
형식: VT_BSTR, 액세스: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_DITHER_PATTERN_DATA
예약되어 있으므로 사용하지 마세요.
형식: VT_I4, 액세스: 읽기 전용, 유효한 값: WIA_PROP_NONE
WIA_DPS_DITHER_SELECT
예약되어 있으므로 사용하지 마세요.
형식: VT_I4, 액세스: 읽기 전용, 유효한 값: WIA_PROP_NONE
WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities
스캐너의 기능을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.
애플리케이션은 이 속성을 읽고 스캐너에 플랫베드, 문서 공급 장치 또는 이중 장치가 설치되어 있는지 여부를 확인합니다. 이 속성은 설치된 기능을 추가로 정의하는 데도 사용됩니다.
형식: VT_I4, 액세스: 읽기 전용, 유효한 값: WIA_PROP_NONE
다음 표에서는 Windows 7에서만 유효한 상수를 설명합니다.
플래그 Description
AUTO_SOURCE 스캐너에 자동 문서 처리기가 설치되어 있습니다.

 

다음 표에서는 Windows 7 및 Windows Vista에서만 유효한 상수를 설명합니다.

플래그 Description
ADVANCED_DUP 디바이스는 고급 이중 검사 구성을 지원합니다. WIA_IPS_DUPLEX_SETTINGS 사용하여 기본 및 고급 이중 구성 사용 간에 전환합니다.
DETECT_FILM_TPA 스캐너는 투명도/필름 어댑터가 스캔할 준비가 된 시기를 감지할 수 있습니다.
DETECT_STOR 스캐너는 내부 스토리지에 문서가 있는 경우를 감지할 수 있습니다.
FILM_TPA 스캐너에는 투명도/필름 스캔 어댑터가 장착되어 있습니다.
STOR 스캐너에는 내부 이미지 스토리지 디바이스가 장착되어 있습니다.

 

다음 표에서는 Windows XP 이상에서 유효한 상수를 설명합니다.

플래그 Description
DETECT_FEED 스캐너는 피더에서 문서를 검색할 수 있습니다.
DETECT_FLAT 스캐너는 평판 도금에서 문서를 감지할 수 있습니다.
DETECT_SCAN 스캐너는 스캔을 통해서만 피더에서 문서를 검색할 수 있습니다.
Dup 스캐너에는 이중이 있습니다.
피드 스캐너에 자동 문서 처리기가 설치되어 있습니다.
플랫 스캐너에는 평판 도금이 있습니다.

 

다음 표에서는 Windows XP에서만 유효한 상수를 설명합니다. 이러한 값은 Windows 7 및 Windows Vista에서 더 이상 사용되지 않으며 사용해서는 안 됩니다.

플래그 Description
DETECT_DUP 스캐너는 사용자의 이중 스캔 요청을 검색할 수 있습니다.
DETECT_DUP_AVAIL 스캐너는 이중체가 설치된 시기를 알 수 있습니다.
DETECT_FEED_AVAIL 스캐너는 자동 문서 공급 장치가 설치된 시기를 알 수 있습니다.

 

WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

참고:
이 속성은 Windows Vista 이상에서 지원되지 않습니다. WIA_IPS_DOCUMENT_HANDLING_SELECT 사용합니다.

 

현재 스캐너 획득 원본 및 모드를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 스캐너의 현재 취득 원본을 확인하거나 스캐너의 원본 및 모드를 설정하기 위해 이 속성을 작성하기 위해 이 속성을 읽습니다. 또한 애플리케이션은 이 속성을 사용하여 이중 함수 기능을 사용하거나 사용하지 않도록 설정합니다.

형식: VT_I4, 액세스: 읽기/쓰기, 유효한 값: WIA_PROP_FLAG

다음 표에는 이 속성에 유효한 10개의 상수가 있습니다.

플래그 Description
피더 문서 피더를 사용하여 검사합니다.
평판 플랫베드로 스캔합니다.
이중 이중 작업을 사용하여 검사합니다.
AUTO_ADVANCE 검사 후 다음 문서를 자동으로 공급할 수 있도록 합니다.
FRONT_FIRST 먼저 문서 앞면을 스캔합니다. 이 값은 DUPLEX가 설정된 경우에 유효합니다.
BACK_FIRST 먼저 문서의 뒷면을 스캔합니다. 이 값은 DUPLEX가 설정된 경우에 유효합니다.
FRONT_ONLY 전면만 스캔합니다. 이 값은 DUPLEX가 설정된 경우에 유효합니다.
BACK_ONLY 뒤로만 스캔합니다. 이 값은 DUPLEX가 설정된 경우에 유효합니다.
NEXT_PAGE 문서의 다음 페이지를 검사합니다.
사전 피드 사전 피드 모드를 사용하도록 설정합니다. 스캔하는 동안 다음 문서를 미리 배치합니다.

 

WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

스캐너가 설치한 플랫베드, 문서 피더 또는 이중의 현재 상태를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 이 속성을 읽어 스캐너 디바이스를 사용할 준비가 되었는지 여부를 확인합니다. 이미지를 획득하기 전에 용지가 피더에 있는지 여부를 검사 이상적인 방법입니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

다음 표에는 이 속성에 유효한 상수가 있습니다. 별표 *는 플래그가 Windows Vista 이상에서 지원되지 않음을 나타냅니다. V 기호는 플래그가 Windows Vista 이상에서만 지원됨을 나타냅니다.

플래그 Description
FEED_READY 플랫베드 사용 준비가 완료되었습니다.
FLAT_READY 스캐너에는 평판 도금에 문서가 있습니다.
DUP_READY 이중 이면을 사용하도록 설정하고 사용할 준비가 된 것입니다.
FLAT_COVER_UP 평평한 침대 덮개는 최대입니다.
PATH_COVER_UP 용지 경로가 가려지고 적절한 작업을 방지하고 있습니다.
PAPER_JAM 문서 피더에 문서가 걸려 있습니다.
FILM_TPA_READYV 투명도 어댑터가 설치되어 사용할 준비가 된 것입니다.
STORAGE_READYV 내부 스토리지 디바이스가 준비되었습니다.
STORAGE_FULLV 스토리지가 가득 차서 업로드 작업이 불가능합니다.
MULTIPLE_FEEDV 여러 피드 조건이 발생했습니다(일반적으로 PAPER_JAM 사용).
DEVICE_ATTENTIONV 디바이스에 대한 사용자 개입이 필요한 오류가 있습니다.
LAMP_ERRV 램프 문제로 인해 스캐너가 준비되지 않았습니다.

 

WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

애플리케이션에서 유효한 보증자 문자열을 만드는 데 사용할 수 있는 모든 유효한 문자를 포함합니다. 보증자는 스캔한 모든 페이지에 문자 메시지를 각인하는 스캐너에 설치된 프린터입니다. 미니 드라이버는 이 속성의 유효한 문자 집합에 대해 WIA_DPS_ENDORSER_STRING 속성 설정의 유효성을 검사해야 합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_BSTR, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

미니드라이버가 검사하는 각 페이지에서 보증(즉, 인쇄)될 문자열을 포함합니다. 애플리케이션은 WIA_DPS_ENDORSER_CHARACTERS 속성에 보고된 유효한 문자 집합을 사용하여 이 속성을 설정합니다. 이 속성에 문자열이 설정된 경우에만 미니드라이버에서 문서를 보증해야 합니다. 빈 문자열은 보증자 기능을 사용할 수 없음을 의미합니다.

보증자 문자열을 해석하는 것은 드라이버의 책임이므로 드라이버는 WIA_DPS_ENDORSER_STRING 특수 문자를 사용할 수 있습니다. 그러나 애플리케이션만 이러한 문자를 이해합니다.

형식: VT_BSTR, Access: 읽기/쓰기, 유효한 값: WIA_PROP_NONE

WIA_DPS_ENDORSER_STRING 속성을 지원하는 드라이버는 다음 토큰 목록을 지원해야 합니다.

토큰 설명
$DATE$ YYYY/MM/DD 형식의 날짜입니다.
$DAY$ DD 형식의 날짜입니다.
$MONTH$ MM 형식의 연도 월입니다.
$PAGE_COUNT$ 전송된 페이지 수입니다.
$TIME$ HH:MM:SS 형식의 하루 중 시간입니다.
$YEAR$ YYYY 형식의 연도입니다.

 

WIA_DPS_FILTER_SELECT

예약되어 있으므로 사용하지 마세요.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceGlobalIdentity

참고:
이 속성은 Windows Vista 이상에서만 지원됩니다.

 

웹 서비스 스캐너 디바이스의 SOAP 주소를 포함합니다. WIA 2.0 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_BSTR, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다.

 

플랫베드에 배치된 문서의 등록 또는 가로 맞춤을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

다음 표에는 이 속성에 유효한 세 개의 상수가 있습니다.

상수 Description
LEFT_JUSTIFIED 용지는 정당화된 상태로 남아 있습니다.
중심 용지가 가운데에 배치됩니다.
RIGHT_JUSTIFIED 이 논문은 정당합니다.

 

참고 항목

WIA_DPS_VERTICAL_BED_REGISTRATION

WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다. WIA_IPS_MAX_HORIZONTAL_SIZE 사용합니다.

 

현재 해상도에서 플랫베드 스캐너의 도판에서 가로(X) 축으로 스캔되는 최대 너비(1000인치)를 지정합니다. 이 속성은 스캔을 위해 시트를 플랫베드 스캐너의 도판으로 이동하는 자동 문서 피더에도 적용됩니다. 이 속성은 도금이 있는 스캐너에 필수입니다. 다른 스캐너 유형은 대신 WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE 속성을 구현합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다. WIA_IPS_MAX_HORIZONTAL_SIZE 사용합니다.

 

현재 해상도의 핸드헬드 또는 시트 피드 스캐너에서 가로(X) 축에서 스캔되는 최대 너비(1000인치)를 지정합니다. 이 속성은 플랫베드 스캐너의 도금으로 시트를 이동하지 않고 스캔하는 자동 문서 피더에도 적용됩니다. 이 속성은 시트 공급, 스크롤 공급 및 휴대용 스캐너에 필수입니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

현재 속성 설정을 사용하여 단일 페이지를 검사하는 최대 시간(밀리초)을 포함합니다. 애플리케이션은 페이지를 검사하는 데 걸리는 시간을 예측하기 위해 이 속성을 읽습니다. 이는 응답을 중지한 디바이스의 조건을 결정할 때 유용합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다. 이 속성은 모든 스캐너에 필요합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다. WIA_IPS_MIN_HORIZONTAL_SIZE 사용합니다.

 

스캐너의 문서 피더가 검색할 수 있는 가장 작은 페이지의 실제 가로 크기를 천 인치 단위로 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

참고 항목

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다. WIA_IPS_MIN_VERTICAL_SIZE 사용합니다.

 

스캐너의 문서 공급 장치가 스캔할 수 있는 가장 작은 페이지의 물리적 세로 크기를 천 분의 1인치 단위로 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

참고 항목

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE

WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_OPTICAL_XRES 사용합니다.

 

가로 광학 해상도. DPI에서 지원되는 가장 높은 수평 광학 해상도입니다. 이 속성은 단일 값입니다. 디바이스에서 생성할 수 있는 모든 해상도 목록은 아닙니다. 대신 디바이스의 광학 해상도입니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다. 이 속성은 모든 스캐너에 필요합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_OPTICAL_YRES 사용합니다.

 

수직 광학 해상도. DPI에서 지원되는 가장 높은 수직 광학 해상도입니다. 이 속성은 단일 값입니다. 디바이스에서 생성되는 모든 해결 방법의 목록은 아닙니다. 대신 디바이스의 광학 해상도입니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다. 이 속성은 모든 스캐너에 필요합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_ORIENTATION
ScannerDeviceOrientation

현재 방향 설정을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 가져올 페이지 또는 이미지의 원래 방향을 정의하도록 WIA_DPS_ORIENTATION 속성을 설정합니다. WIA_DPS_ORIENTATION 사용하는 방법에 대한 자세한 내용은 WIA_DPS_PAGE_SIZE

형식: VT_I4, Access: 읽기/쓰기, 유효한 값: WIA_PROP_LIST

다음 표에는 이 속성에 유효한 4개의 상수가 있습니다.

정의
LANDSCAPE 세로 방향을 기준으로 시계 반대 방향으로 90도 회전합니다.
초상화 0도.
ROT180 세로 방향을 기준으로 시계 반대 방향으로 180도 회전합니다.
ROT270 세로 방향을 기준으로 시계 반대 방향으로 270도 회전합니다.

 

참고 항목

WIA_IPS_ROTATION

WIA_DPS_PAD_COLOR
ScannerDevicePadColor

요청된 버퍼를 채울 이미지 데이터가 충분하지 않은 경우 패딩에 사용되는 색입니다. 이 속성은 버퍼를 패딩하는 스캐너에 대해 구현됩니다. 이 속성은 모든 스캐너에 대해 선택 사항입니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_UI1 | VT_VECTOR, 액세스: 읽기 전용, 유효한 값: WIA_PROP_NONE

색 정보의 형식은 RGBQUAD입니다.

WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_PAGE_HEIGHT 사용합니다.

 

현재 선택한 페이지의 높이(천 분의 1인치)를 포함합니다. 미니 드라이버는 WIA_DPS_PAGE_HEIGHT 속성을 만들고 유지 관리합니다. 애플리케이션은 이 속성을 읽어 검사 중인 페이지의 물리적 차원을 확인합니다. 익스텐트 설정이 알려진 페이지 크기와 다른 경우 이 속성은 WIA_DPS_PAGE_SIZE 속성이 WIA_PAGE_CUSTOM(WIA_DPS_PAGE_SIZE속성의 값)로 설정된 페이지의 높이를 보고합니다. WIA_DPS_PAGE_HEIGHT 스캔할 페이지의 높이를 픽셀 단위로 보고하는 WIA_IPS_XEXTENT 동기화되어야 합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_PAGE_SIZE 사용합니다.

 

현재 검사할 페이지 크기를 포함합니다. 검사할 페이지의 크기를 선택하려면 애플리케이션에서 이 속성을 설정합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4, Access: 읽기/쓰기, 유효한 값: WIA_PROP_LIST

다음 표에는 이 속성에 유효한 세 개의 상수가 있습니다.

정의
WIA_PAGE_A4 8267 X 11692(세로 방향)
WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT WIA_DPS_PAGE_WIDTH 속성의 값으로 정의됨
WIA_PAGE_LETTER 8500 X 11000(세로 방향)

 

WIA_IPS_ORIENTATION 속성의 값은 현재 선택한 페이지의 방향을 결정합니다. WIA_DPS_PAGE_WIDTHWIA_DPS_PAGE_HEIGHT 속성은 페이지의 크기를 천 인치 단위로 보고합니다. 이러한 속성은 페이지의 크기를 픽셀 단위로 포함하는 WIA_IPS_XEXTENTWIA_IPS_YEXTENT 일치해야 합니다. WIA_PROP_LIST 형식의 유효한 값은 WIA_IPS_ORIENTATION 속성의 유효한 설정에 따라 달라집니다. 디바이스가 WIA_PAGE_A4 설정으로 가로 지향 문서를 검색할 수 없는 경우 WIA_IPS_ORIENTATION LANSCAPE로 설정된 경우 WIA_DPS_PAGE_SIZE 속성의 유효한 값 목록에 WIA_PAGE_A4 표시되지 않아야 합니다.

애플리케이션이 WIA_DPS_PAGE_SIZE WIA_PAGE_CUSTOM 이외의 값으로 설정하는 경우 미니 드라이버는 WIA_DPS_PAGE_WIDTH 값을 조정하고 10000인치 단위로 페이지의 차원으로 WIA_DPS_PAGE_HEIGHT 합니다. 또한 WIA_IPS_XEXTENTWIA_IPS_YEXTENT 값을 페이지의 크기(픽셀)로 조정해야 합니다.

익스텐트 설정(WIA_IPS_XEXTENT 또는 WIA_IPS_YEXTENT)이 현재 페이지 크기 설정과 일치하지 않는 값으로 변경되면 미니드라이버가 WIA_DPS_PAGE_SIZE 속성의 값을 WIA_PAGE_CUSTOM 변경해야 합니다. 또한 미니 드라이버는 새 익스텐트 설정에 따라 WIA_DPS_PAGE_WIDTH 수정하거나 WIA_DPS_PAGE_HEIGHT 합니다.

WIA_IPS_ORIENTATION LANSCAPE로 설정된 경우 익스텐트 설정은 "대칭 이동"됩니다. 예를 들어 애플리케이션이 WIA_DPS_PAGE_SIZE WIA_PAGE_A4 설정하는 경우 미니 드라이버는 WIA_DPS_PAGE_WIDTH 11692로 설정하고 WIA_DPS_PAGE_HEIGHT 8267로 설정해야 합니다. 미니드라이버도 WIA_IPS_XEXTENT 설정해야 하며 그에 따라 WIA_IPS_YEXTENT . WIA_DPS_PAGE_SIZE WIA_PAGE_CUSTOM 설정된 경우 방향 설정은 스캔할 페이지의 익스텐트 크기를 결정하는 데 사용되지 않습니다.

미니 드라이버는 WIA_IPS_ORIENTATION 속성이 현재 선택 영역과 일치하는지 확인합니다. 애플리케이션이 WIA_IPS_ORIENTATION 값을 현재 선택한 페이지 크기에 잘못된 값으로 변경하는 경우 미니드라이버에서 WIA_DPS_PAGE_SIZE 값을 새 방향 값에서 지원하는 페이지 크기로 변경해야 합니다.

애플리케이션이 WIA_DPS_PAGE_SIZE 속성을 WIA_PAGE_CUSTOM 설정하면 현재 선택 영역은 영향을 받지 않습니다. WIA 미니 드라이버는 WIA_IPS_XPOS WIA_IPS_YPOS 속성의 현재 설정부터 시작하여 현재 이미지 레이아웃을 가져와야 합니다. 페이지 크기 설정으로 인해 스캐너의 침대 외부에 있는 선택 영역이 발생하는 경우 미니 드라이버는 WIA_IPS_XPOSWIA_IPS_YPOS 속성의 값을 유효한 설정으로 자동으로 조정해야 합니다. WIA_DPS_PAGE_SIZEWIA_IPS_ORIENTATION 속성이 동시에 설정되고 함께 적용할 때 유효하지 않은 경우 미니드라이버가 IWiaMiniDrv::d rvValidateItemProperties에서 오류를 반환하여 애플리케이션의 설정을 실패해야 합니다. .

다음 네 가지 예제에서는 서로 다른 WIA_DPS_PAGE_SIZE 시나리오를 보여 줍니다.

  1. 드라이버는 설정을 보고합니다.
  2. 애플리케이션은 WIA_DPS_PAGE_SIZE 속성을 WIA_PAGE_LETTER 설정합니다.
  3. 애플리케이션은 WIA_IPS_ORIENTATION 속성을 LANSCAPE로 설정합니다.
  4. 애플리케이션은 WIA_IPS_XEXTENT 속성을 더 작은 값으로 변경합니다.

예제 1: 미니 드라이버가 설정을 보고합니다.

다음 예제에서 미니 드라이버는 애플리케이션이 WIA 속성을 설정하기 전에 사용자 지정 선택 영역을 설정합니다. 이 경우 선택 영역은 전체 평면을 나타냅니다.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

예제 2: 애플리케이션은WIA_DPS_PAGE_SIZE속성을 WIA_PAGE_LETTER 설정합니다.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

예제 3: 애플리케이션은WIA_IPS_ORIENTATION속성을 LANSCAPE로 설정합니다.

실제 침대는 원래 가로 방향의 페이지를 얻을 수 있어야합니다.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

예제 4: 애플리케이션이WIA_IPS_XEXTENT속성을 더 작은 값으로 변경합니다.

다음 예제에서 애플리케이션은 WIA_IPS_XEXTENT 속성을 1000으로 변경합니다. 미니 드라이버는 WIA_IPS_XEXTENT 포함된 새 값이 WIA_DPS_PAGE_SIZE 속성에 더 이상 유효하지 않으므로 WIA_DPS_PAGE_SIZEWIA_PAGE_CUSTOM 변경해야 한다고 가정해야 합니다. 미니드라이버도 WIA_DPS_PAGE_WIDTH 조정해야 합니다.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100
WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_PAGE_WIDTH 사용합니다.

 

선택한 현재 페이지의 너비(천 분의 1인치)를 포함합니다. 애플리케이션은 이 속성을 읽어 검사 중인 페이지의 물리적 차원을 확인합니다. 익스텐트 설정이 알려진 페이지 크기와 다른 경우 이 속성은 WIA_DPS_PAGE_SIZE 속성이 WIA_PAGE_CUSTOM 설정된 페이지의 너비를 보고합니다. WIA_DPS_PAGE_WIDTH 스캔할 페이지의 너비를 픽셀 단위로 보고하는 WIA_IPS_XEXTENT 값과 동기화되어야 합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_PAGES
ScannerDevicePages

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_PAGES 사용합니다.

 

자동 문서 피더에서 가져올 현재 페이지 수를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4; 액세스: 읽기/쓰기; 유효한 값: WIA_PROP_RANGE (문서 공급 장치가 보유할 수 있는 최대 페이지 수까지 0)

애플리케이션은 이 속성을 읽어 문서 피더의 페이지 용량을 확인합니다. 또한 애플리케이션은 이 속성을 검사할 페이지 수로 설정합니다.

참고:
이중 모드를 사용하는 경우(WIA_DPS_DOCUMENT_HANDLING_SELECT FEEDER로 설정됨 | DUPLEX ), WIA_DPS_PAGES 검사할 페이지 수와 여전히 같습니다.

 

페이지의 뒷면이 비어 있더라도 DUPLEX를 사용하도록 설정하면 용지 한 장의 페이지가 자동으로 두 페이지씩 포함됩니다.

WIA_DPS_PAGES 1로 설정하면 스캐너가 페이지의 측면 중 하나를 처리합니다. 스캐너가 이중 모드인 동안 페이지의 한 쪽만 스캔할 수 없는 경우 WIA_PROPERTY_INFO 구조체의 Inc 멤버에 대한 WIA_DPS_PAGES 유효한 값을 2로 변경하는 것이 좋습니다. 이 값은 애플리케이션에 두 개의 배수로 페이지를 요청해야 한다는 신호를 보냅니다. 값이 0이면 현재 문서 공급 장치에 로드된 모든 페이지를 검사해야 합니다.

WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

스캔할 시트 뒷면의 도금 색을 지정합니다. 이 속성은 도금이 있는 스캐너의 경우 선택 사항입니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_UI1 | VT_VECTOR, 액세스: 읽기 전용, 유효한 값: WIA_PROP_NONE

색 정보의 형식은 RGBQUAD입니다.

WIA_DPS_PREVIEW
ScannerDevicePreview

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_PREVIEW 사용합니다.

 

디바이스의 미리 보기 모드를 나타냅니다. 애플리케이션은 이 속성을 설정하여 디바이스를 미리 보기 모드로 전환합니다.

형식: VT_I4, Access: 읽기/쓰기, 유효한 값: WIA_PROP_LIST

다음 표에는 이 속성에 유효한 두 개의 상수가 있습니다.

정의
WIA_FINAL_SCAN 애플리케이션은 최종 검사를 수행합니다.
WIA_PREVIEW_SCAN 애플리케이션은 미리 보기 검사를 수행합니다.

 

WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

스캐너가 애플리케이션으로 보내기 전에 스캐너 버퍼의 페이지를 캐시할지 여부를 나타내는 값을 포함합니다.

값이 0이면 미리 검사를 사용하지 않도록 설정되며 미리 검사할 페이지가 없습니다. 버퍼링된 스캔 미리 항목에서 일반 데이터 전송을 수행하면 버퍼링된 페이지가 검색됩니다. 미리 검사 작업 중에는 WIA 속성을 변경할 수 없습니다. 이 속성은 선택 사항입니다.

형식: VT_I4, Access: 읽기/쓰기, 유효한 값: 문서 공급 장치가 보유할 수 있는 최대 페이지 수까지 0의 WIA_PROP_RANGE.

WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

참고:
이 속성은 Windows 7 이상에서만 지원됩니다.

 

검색할 입력 원본(플랫베드, 자동 문서 공급기 또는 필 스캔 어댑터) 또는 데이터를 전송할 스토리지 위치를 나타냅니다.

검사 이벤트는 사용자가 검사를 시작했음을 애플리케이션에 알립니다. 하지만 이벤트는 입력 소스를 나타내는 WIA 항목의 이름을 제공하지 않습니다. 애플리케이션의 이벤트 처리기는 루트 항목의 WIA_DPS_SCAN_AVAILABLE_ITEM 속성을 쿼리하여 입력 원본 항목의 이름을 가져올 수 있습니다.

형식: VT_I4, Access: 읽기/쓰기, 유효한 값: 문서 공급 장치가 보유할 수 있는 최대 페이지 수까지 0의 WIA_PROP_RANGE.

WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

참고:
이 속성은 Windows Vista 이상에서만 지원됩니다.

 

Web Services 스캐너 디바이스의 서비스 ID를 포함합니다. WIA 2.0 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_BSTR, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다. WIA_IPS_SHEET_FEEDER_REGISTRATION 사용합니다.

 

플랫베드에 배치된 문서에 대한 등록 또는 맞춤 및 에지 검색을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다. 이 속성은 시트가 핸드헬드 또는 시트 공급 스캐너의 스캔 헤드에 가로로 배치되는 방식을 나타냅니다. 속성은 스캔 헤드에서 문서가 배치되는 위치를 예측하는 데 사용됩니다.

둘 이상의 스캔 헤드를 지원하는 스캐너의 경우 이 속성은 최상위 스캔 헤드를 기준으로 합니다. 이 속성은 시트 공급, 스크롤 공급 및 핸드헬드 스캐너에 필수입니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

다음 표에는 이 속성에 유효한 세 개의 상수가 있습니다.

상수 Description
LEFT_JUSTIFIED 시트는 스캔 헤드와 관련하여 왼쪽에 배치됩니다.
중심 시트는 스캔 헤드의 가운데에 있습니다.
RIGHT_JUSTIFIED 시트는 스캔 헤드와 관련하여 오른쪽에 배치됩니다.

 

WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

참고:
이 속성은 Windows Vista에서 지원되지 않습니다. WIA_IPS_SHOW_PREVIEW_CONTROL 사용합니다.

 

항목에 사용자에게 표시되는 미리 보기 컨트롤이 필요한지 여부를 나타냅니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

다음 표에는 이 속성에 유효한 두 개의 상수가 있습니다.

상수 Description
WIA_SHOW_PREVIEW_CONTROL 이 디바이스는 미리 보기를 수행할 수 있으므로 미리 보기 컨트롤을 사용자에게 표시합니다.
WIA_DONT_SHOW_PREVIEW_CONTROL 이 디바이스는 미리 보기를 수행할 수 없으므로 사용자에게 미리 보기 컨트롤을 표시하지 마세요.

 

WIA_DPS_USER_NAME
ScannerDeviceUserName

참고:
이 속성은 Windows Vista 이상에서만 지원됩니다.

 

WIA 서비스에서 현재 WIA 애플리케이션이 실행 중인 세션의 사용자 계정 이름(해당하는 경우 네트워크 도메인 이름 포함)에 대해 미니 드라이버에 알리는 데 사용됩니다.

WIA 서비스에서 관리하는 루트 항목 속성입니다.

형식: VT_BSTR, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다.

 

플랫베드에 배치된 문서에 대한 등록 또는 세로 맞춤 및 에지 검색을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

다음 표에는 이 속성에 유효한 세 개의 상수가 있습니다.

상수 Description
TOP_JUSTIFIED 용지가 맨 위에 맞춤되어 있습니다.
중심 용지가 가운데에 배치됩니다.
BOTTOM_JUSTIFIED 용지가 아래쪽에 맞춤되어 있습니다.

 

참고 항목도 참조하세요.

WIA_DPS_HORIZONTAL_BED_REGISTRATION

WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다. WIA_IPS_MAX_VERTICAL_SIZE 사용합니다.

 

현재 해상도에서 플랫베드 스캐너의 도판에서 세로(Y) 축으로 스캔되는 최대 높이(1000인치)를 지정합니다. 이 속성은 스캔을 위해 시트를 플랫베드 스캐너의 도판으로 이동하는 자동 문서 공급 장치에도 적용됩니다. 이 속성은 도금이 있는 스캐너에 필수입니다. 다른 스캐너 유형은 대신 WIA_DPS_VERTICAL_SHEET_FEED_SIZE 속성을 구현합니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

참고:
이 속성은 Windows Vista 이상에서는 지원되지 않습니다. WIA_IPS_MAX_VERTICAL_SIZE 사용합니다.

 

현재 해상도에서 핸드헬드 또는 시트 피드 스캐너에서 세로(Y) 축으로 스캔되는 최대 높이(1000인치)를 지정합니다. 이 속성은 플랫베드 스캐너의 도금으로 시트를 이동하지 않고 스캔하는 자동 문서 피더에도 적용됩니다. 이 속성은 시트 공급 스캐너에 필수입니다. 스크롤 공급 및 휴대용 스캐너는 이 속성을 구현해서는 안 됩니다.

형식: VT_I4, Access: 읽기 전용, 유효한 값: WIA_PROP_NONE

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2003 [데스크톱 앱만 해당]
헤더
Wiadef.h