다음을 통해 공유


WIA_DPS_SCAN_AVAILABLE_ITEM

WIA_DPS_SCAN_AVAILABLE_ITEM 속성은 애플리케이션이 프로그램 제어에서 수행하는 푸시 스캔 작업에 대한 입력 원본의 이름을 제공합니다. WIA 미니드라이버에서 이 속성을 만들고 유지 관리합니다.

속성 형식: VT_BSTR

유효한 값: WIA_PROP_NONE

액세스 권한: 읽기 전용

설명

Windows 7 이상에서 WIA_DPS_SCAN_AVAILABLE_ITEM WIA 스캐너 디바이스의 WIA 항목 트리에 있는 루트 항목의 선택적 속성입니다. 애플리케이션에서 검색할 입력 원본(플랫베드, 자동 문서 공급기 또는 필름 스캔 어댑터) 또는 데이터를 전송할 스토리지 위치를 확인하기 위해 이 속성을 쿼리할 수 있습니다.

일부 WIA 스캐너 디바이스를 사용하면 사용자가 디바이스의 전면 패널에서 검사 작업의 입력 원본을 선택하거나 디바이스의 피더에 문서를 삽입하여 입력 원본을 암시적으로 선택할 수 있습니다. 사용자가 디바이스에서 시작 검사 단추를 누르면 애플리케이션은 사용자가 선택한 입력 원본을 결정하여 이 원본에서 검사 작업을 시작할 수 있도록 해야 합니다.

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

WIA 트리의 루트 항목에는 디바이스의 입력 소스를 나타내는 하나 이상의 자식 항목(플랫베드 항목, 피더 항목 및 필름 항목)이 있습니다. 이러한 각 항목은 입력 원본의 파트 또는 영역을 나타내는 자식 항목의 부모 항목일 수 있습니다. 루트 항목의 자식이고 전체적으로 플랫베드를 나타내는 플랫베드 항목에는 플랫베드 표면의 개별 영역을 나타내는 자식(플랫베드 항목이기도 함)이 있을 수 있습니다. 루트 항목의 자식이고 자동 문서 피더를 나타내는 피더 항목에는 피더를 통과하는 문서 페이지의 앞면과 후면에 대한 스캐너를 나타내는 자식이 있을 수 있습니다. 루트 항목의 자식이고 전체적으로 필름 스캔 어댑터를 나타내는 필름 항목에는 개별 필름 프레임을 나타내는 자식(필름 항목이기도 함)이 있을 수 있습니다. 사용자가 요청한 검사 작업에 따라 WIA_DPS_SCAN_AVAILABLE_ITEM 속성은 루트의 자식인 플랫베드, 피더 또는 필름 항목의 이름을 지정하거나 이러한 항목 중 하나의 자식 이름을 지정할 수 있습니다. 이러한 항목에 대한 자세한 내용은 WIA 항목 범주를 참조하세요.

검사 이벤트가 발생하면 드라이버는 즉시 WIA_DPS_SCAN_AVAILABLE_ITEM 속성 값을 WIA 항목 이름(항목의 WIA_IPA_ITEM_NAME 속성에 의해 보고됨)으로 즉시 설정하여 이 정보가 알려진 경우 스캔 작업을 사용할 수 있는 입력 원본을 식별합니다. 그렇지 않으면 입력 소스를 알 수 없는 경우 드라이버는 속성 값을 빈 문자열로 설정합니다. 애플리케이션이 검사 이벤트를 사용하는 경우 검색 이벤트의 상태가 신호에서 신호가 아닌 상태로 변경되고 드라이버는 WIA_DPS_SCAN_AVAILABLE_ITEM 속성 값을 빈 문자열로 다시 설정합니다.

이 속성에 대한 자세한 내용은 Scan 이벤트에 대한 입력 원본 식별을 참조하세요.

요구 사항

헤더: wiadef.h(Wiadef.h 포함)

추가 정보

WIA_IPA_ITEM_NAME