다음을 통해 공유


일반적인 WIA 항목 속성 상수

설명에 달리 명시되지 않는 한 다음 디바이스 속성 상수는 모든 IWiaItem, IWiaItem2IWiaDrvItem 인터페이스 인터페이스에서 지원되어야 합니다.

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

상수/값 설명
WIA_IPA_ACCESS_RIGHTS
PictureAccessRights
이 플래그는 항목에 대한 액세스와 항목 삭제 여부를 제어합니다.
모든 WIA 2.0 항목에 필요합니다.
형식: VT_I4; 항목의 액세스 권한을 변경하는 기능에 따라 읽기/쓰기 또는 읽기 전용입니다. 유효한 값: WIA_PROP_FLAG
다음 표에는 이 속성에 유효한 5개의 플래그가 있습니다.
액세스 권한 Description
WIA_ITEM_READ 항목에 읽기 전용 액세스 권한이 있습니다.
WIA_ITEM_WRITE 항목에 쓰기 전용 액세스 권한이 있습니다.
WIA_ITEM_CAN_BE_DELETED 항목에 삭제 전용 액세스 권한이 있습니다.
WIA_ITEM_RD WIA_ITEM_READ | WIA_ITEM_CAN_BE_DELETED
WIA_ITEM_RWD WIA_ITEM_READ | WIA_ITEM_WRITE | WIA_ITEM_CAN_BE_DELETED

 

WIA_IPA_APP_COLOR_MAPPING
PictureAppColorMapping

이 속성은 나중에 사용하기 위해 에 의해 예약되며 현재 구현되지 않습니다.

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

WIA_IPA_BITS_PER_CHANNEL
PictureBitsPerChannel

이미지의 채널당 비트 수를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

모든 WIA 2.0 획득 사용 또는 저장된 이미지 항목에 필요합니다.

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

WIA_IPA_BUFFER_SIZE
PictureBufferSize

데이터 전송 중에 사용되는 버퍼의 크기(바이트)를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션 데이터 전송에 대 한 드라이버 지정 버퍼 크기를 확인 하려면이 속성을 읽을 수 있습니다. WIA 서비스는 또한 데이터 전송 중에 미니 드라이버에 대한 메모리를 할당하기 위해 이 속성을 읽습니다.

모든 전송 사용 WIA 2.0 항목에 대해 선택 사항입니다.

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

참고:
포함되는 WIA_IPA_BUFFER_SIZE 속성은 애플리케이션이 지정된 시간에 요청할 수 있는 최소 데이터 양입니다. 버퍼 크기가 클수록 디바이스에 대한 요청이 커지게 됩니다. 이렇게 하면 디바이스가 느리고 응답하지 않는 것처럼 보이고, 전체 시스템 성능이 느려질 수 있으며, 과도한 리소스를 사용할 수 있습니다. 버퍼 크기가 너무 작을 경우 더 작은 요청이 많이 필요하므로 데이터 전송 성능이 저하될 수 있습니다. 디바이스에 대한 데이터 요청의 일반적인 크기를 고려하고 요청 수와 해당 요청의 크기를 균형 조정하여 적절한 버퍼 크기를 선택합니다.

 
WIA_IPA_BYTES_PER_LINE
PictureBytesPerLine

이미지의 한 스캔 줄에 있는 바이트 수를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

모든 WIA 2.0 항목에 대해 선택 사항입니다.

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

WIA_IPA_CHANNELS_PER_PIXEL
PictureChannelsPerPixel

이미지의 픽셀당 채널 수를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

모든 WIA 2.0 획득 사용 또는 저장된 이미지 항목에 필요합니다.

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

WIA_IPA_COLOR_PROFILE
PictureColorProfile

이 속성은 나중에 사용하기 위해 에 의해 예약되며 현재 구현되지 않습니다.

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

WIA_IPA_COMPRESSION
PictureCompression

사용되는 현재 압축 형식을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 이 속성을 읽어 이미지 압축 유형을 확인하거나 이 속성을 설정하여 압축 설정을 구성합니다.

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

다음 표에는 이 속성에 유효한 상수가 있습니다. V 기호는 상수가 Windows Vista 이상에서만 지원됨을 나타냅니다. ( IWiaItem2 인터페이스를 통해서만 사용할 수 있습니다.)

압축 유형 Description
WIA_COMPRESSION_NONE 압축이 없습니다. 자세한 내용은 참고 를 참조하세요.
WIA_COMPRESSION_AUTO 자동 압축 모드. 자세한 내용은 참고 를 참조하세요.
WIA_COMPRESSION_BI_RLE4 RLE4 압축
WIA_COMPRESSION_BI_RLE8 RLE8 압축
WIA_COMPRESSION_G3 그룹 3 압축
WIA_COMPRESSION_G4 그룹 4 압축
WIA_COMPRESSION_JPEG JPEG 압축.
WIA_COMPRESSION_JBIGV JBIG 압축.
WIA_COMPRESSION_JPEG2KV JPEG 2000 압축.
WIA_COMPRESSION_PNGV PNG 압축.

 

[!Note]

이 속성이 WIA_COMPRESSION_NONE WIA_IPA_FORMAT WiaImgFmt_PDFA 또는 WiaImgFmt_XPS 경우 WIA_COMPRESSION_NONE 압축 모드가 정의되지 않았으며 스캐너가 모드를 결정해야 했음을 의미합니다.

WIA_COMPRESSION_AUTO WIA_IPA_COMPRESSION 속성에 대해 정의된 새 속성 값입니다. 이 값은 Flatbed 및 Feeder를 비롯한 모든 프로그래밍 가능한 이미지 데이터 원본 항목에 유효합니다. WIA 미니 드라이버에서 이 값을 지원하는 경우 WIA 애플리케이션 클라이언트는 디바이스에서 자동 압축 모드 검색을 사용하도록 설정하기 위해 WIA_IPA_COMPRESSION 설정할 수 있습니다. WIA_COMPRESSION_AUTO 전체 자동 색을 지원하거나 사용하도록 설정하지 않고도 사용할 수 있습니다(WIA_DATA_AUTO 및 WIA_DEPTH_AUTO).

WIA_COMPRESSION_AUTO WiaImgFmt_RAW 같은 여러 데이터 형식 및 비트 깊이를 지원하는 파일 형식 전송에 가장 유용합니다. 파일 형식 전송에 대한 자세한 내용은 이 표의 WIA_IPA_FORMAT 참조하세요.

WIA 미니 드라이버가 WIA_COMPRESSION_AUTO 수 있도록 하는 것은 아편입니다. 지원되는 경우 WIA 미니 드라이버는 WIA_IPA_COMPRESSION 기본값으로 설정해서는 안 됩니다. WIA 애플리케이션만 이 값을 설정할 수 있습니다.

 
WIA_IPA_DATATYPE
PictureDatatype

디바이스에 대한 현재 데이터 형식 설정을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 이미지의 데이터 형식을 결정하기 위해 이 속성을 읽습니다. 애플리케이션은 전송할 이미지의 현재 데이터 형식을 설정하기 위해 이 속성을 씁니다.

이 속성은 모든 WIA 2.0 항목에 필요합니다. 모든 WIA 2.0 획득 사용 항목에 대해 읽기/쓰기가 가능하고 WIA 2.0 스토리지 항목의 경우 읽기 전용이어야 합니다.

형식: VT_I4; Windows Vista 이전 운영 체제에 대한 액세스: 이 속성은 카메라의 경우 읽기 전용이고 스캐너의 경우 읽기/쓰기입니다. Windows Vista 이상에 대한 액세스: 이 속성은 WIA_CATEGORY_FOLDER 및 WIA_CATEGORY_FINISHED_FILE 항목에 대해 읽기 전용이고 다른 모든 WIA 2.0 항목 범주의 경우 읽기/쓰기입니다. 유효한 값: WIA_PROP_LIST

다음 표에는 WIA_IPA_FORMAT WiaImgFmt_RAW 설정되지 않은 경우 유효한 6개의 상수가 있습니다.

데이터 형식 Description
WIA_DATA_AUTO Flatbed 및 Feeder를 비롯한 모든 프로그래밍 가능한 이미지 데이터 원본 항목에 유효합니다. WIA 미니 드라이버에서 이 값을 지원하는 경우 WIA 애플리케이션 클라이언트는 디바이스에서 자동 색 검색을 사용하도록 설정하기 위해 WIA_IPA_DATATYPE 설정할 수 있습니다. WIA_DATA_AUTO 설정되면 WIA 미니 드라이버는 동일한 항목의 WIA_IPA_DEPTH WIA_DEPTH_AUTO 업데이트해야 합니다(디바이스가 자동 색을 지원하는 경우 지원되는 값이어야 함).
선택적 값이지만 WIA_IPA_DEPTH WIA_DEPTH_AUTO 지원되는 경우 필요합니다.
WIA_DATA_COLOR 스캔 데이터는 빨강, 녹색, 파랑(RGB) 색입니다. 전체 색 형식은 다음 WIA 속성을 사용하여 설명합니다. WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PLANAR
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_DATA_COLOR_DITHER 현재 선택한 디더 패턴을 사용하여 데이터를 디더링한다는 점을 제외하고 WIA_DATA_COLOR 동일합니다.
WIA_DATA_COLOR_THRESHOLD 데이터를 검사할 때 임계값이 사용된다는 점을 제외하고 WIA_DATA_COLOR 동일합니다. WIA_IPS_THRESHOLD 값의 색 값은 전체 밝기로 변환됩니다. 이 값 아래의 색은 검은색으로 변환됩니다.
WIA_DATA_DITHER 스캔 데이터는 현재 선택한 디더 패턴을 사용하여 디더링됩니다.
WIA_DATA_GRAYSCALE 스캔 데이터는 강도를 나타냅니다. 색상표는 WIA_IPA_DEPTH 속성으로 지정된 깊이가 있는 고정된 동일한 간격의 회색 눈금입니다.
WIA_DATA_THRESHOLD 임계값은 흑백 데이터의 픽셀당 1비트입니다. WIA_IPS_THRESHOLD 현재 값에 대한 데이터는 흰색으로 변환됩니다. 이 값 아래의 데이터는 검은색으로 변환됩니다.

 

WIA_IPA_DATATYPE 속성은 애플리케이션이 WiaImgFmt_RAW 설정될 때 사용할 RAW 데이터 전송 유형을 설명하는 데도 사용됩니다. 드라이버는 WIA_IPA_DATATYPE 속성을 애플리케이션에서 선택할 수 있는 허용된 값 목록으로 설정해야 합니다.

디바이스를 단일 값으로만 설정할 수 있는 경우 WIA_PROP_LIST 형식을 만들고 유효한 값을 입력합니다.

WIA_IPA_DEPTH 속성을 확인하여 비트 깊이를 확인합니다. 이 속성은 일반적으로 카메라에 대 한 단일 값을 포함 합니다.

다음 표에서는 WIA_IPA_FORMAT WiaImgFmt_RAW 설정된 경우 WIA_IPA_DATATYPE 유효한 상수를 나열합니다.

데이터 형식 Description
WIA_DATA_GRAYSCALE 스캔 데이터는 강도를 나타냅니다. 색상표는 WIA_IPA_DEPTH 속성에 지정된 깊이가 있는 고정된 간격의 회색조입니다. WIA_IPA_RAW_BITS_PER_CHANNEL 1로 설정해야 합니다.
WIA_DATA_RAW_BGR 스캔 데이터는 BGR(파란색-녹색-빨간색) 색 영역에 있습니다. 전체 색 형식은 다음WIAproperties를 사용하여 설명합니다. WIA_IPA_CHANNELS_PER_PIXEL
WIA_IPA_BITS_PER_CHANNEL
WIA_IPA_PIXELS_PER_LINE
WIA_IPA_BYTES_PER_LINE
WIA_IPA_NUMBER_OF_LINES
WIA_IPA_RAW_BITS_PER_CHANNEL 3으로 설정해야 합니다.
WIA_DATA_RAW_CMY 스캔 데이터는 CYAN-magenta-yellow(CMY) 색 영역에 있습니다. 전체 색 형식은 WIA_DATA_RAW_BGR 와 동일한 WIA 속성을 사용하여 설명합니다. WIA_IPA_RAW_BITS_PER_CHANNEL 3으로 설정해야 합니다.
WIA_DATA_RAW_CMYK 스캔 데이터는 Cyan-magenta-yellow-black(CMYK) 색 영역에 있습니다. 전체 색 형식은 WIA_DATA_RAW_BGR 와 동일한 WIA 속성을 사용하여 설명합니다. WIA_IPA_RAW_BITS_PER_CHANNEL 4로 설정해야 합니다.
WIA_DATA_RAW_RGB 스캔 데이터는 RGB(빨간색-녹색-파란색) 색 영역에 있습니다. 전체 색 형식은 WIA_DATA_RAW_BGR 와 동일한 WIA 속성을 사용하여 설명합니다. WIA_IPA_RAW_BITS_PER_CHANNEL 3으로 설정해야 합니다.
WIA_DATA_RAW_YUV 스캔 데이터는 YUV(광도-파란색 차이-빨간색 차이) 색 영역에 있습니다. 전체 색 형식은 WIA_DATA_RAW_BGR 와 동일한 WIA 속성을 사용하여 설명합니다. WIA_IPA_RAW_BITS_PER_CHANNEL 3으로 설정해야 합니다.
WIA_DATA_RAW_YUVK 스캔 데이터는 LUMINANCE-blue difference-red difference-black(YUVK) 색 영역에 있습니다. 전체 색 형식은 WIA_DATA_RAW_BGR 와 동일한 WIA 속성을 사용하여 설명합니다. WIA_IPA_RAW_BITS_PER_CHANNEL 4로 설정해야 합니다.

 

WIA_IPA_DEPTH
PictureDepth

WIA_IPA_DEPTH 이미지의 비트 깊이 설정을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다. 애플리케이션은 이미지의 비트 깊이 설정을 결정하기 위해 이 속성을 읽습니다. 애플리케이션은 이 값을 원하는 비트 깊이로 설정할 수도 있습니다.

디바이스를 단일 값으로만 설정할 수 있는 경우 WIA_PROP_LIST 형식을 만들고 유효한 값을 입력합니다.

이 속성은 모든 WIA 2.0 항목에 필요합니다. 모든 WIA 2.0 획득 사용 항목에 대해 읽기/쓰기가 가능하고 WIA 2.0 스토리지 항목의 경우 읽기 전용이어야 합니다.

형식: VT_I4; Windows Vista 이전 운영 체제에 대한 액세스: 읽기/쓰기; Windows Vista 이상에 대한 액세스: 이 속성은 WIA_CATEGORY_FOLDER 및 WIA_CATEGORY_FINISHED_FILE 항목에 대해 읽기 전용이고 다른 모든 WIA 2.0 항목 범주의 경우 읽기/쓰기입니다. 유효한 값: WIA_PROP_LIST

WIA_DEPTH_AUTO 픽셀당 0비트로 정의되며 WIA_IPA_DEPTH 대해 정의된 새 속성 값입니다. 이 값은 Flatbed 및 Feeder를 비롯한 모든 프로그래밍 가능한 이미지 데이터 원본 항목에 유효합니다. WIA 미니 드라이버에서 WIA_DEPTH_AUTO 지원되는 경우 WIA 애플리케이션 클라이언트는 WIA_IPA_DEPTH 이 값으로 설정하여 디바이스에서 자동 색 감지를 사용하도록 설정할 수 있습니다. WIA_DEPTH_AUTO 설정되면 WIA 미니 드라이버는 동일한 항목의 WIA_IPA_DATATYPE WIA_DATA_AUTO 업데이트해야 합니다(디바이스가 자동 색을 지원하는 경우 지원되는 값이어야 함).

WIA_DEPTH_AUTO 선택적 값이지만 WIA_DATA_AUTO WIA_IPA_DATATYPE 지원되는 경우 필요합니다.

WIA_IPA_FILENAME_EXTENSION
PictureFilenameExtension

특정 파일 형식의 파일 이름 확장명을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

모든 전송 사용 WIA 2.0 항목에 대한 선택 사항입니다.

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

드라이버는 WIA_IPA_FORMAT 속성의 현재 값을 반영하도록 이 속성을 업데이트합니다.

예를 들어 WIA_IPA_FORMAT WiaImgFmt_JPEG 경우 WIA_IPA_FILENAME_EXTENSIONjpg여야 합니다. WIA_IPA_FORMAT WiaImgFmt_BMP 경우 WIA_IPA_FILENAME_EXTENSION BMP여야 합니다.

참고:
파일 이름 확장명은 점을 포함하지 않습니다.

 

이 속성은 표준 형식을 지원하는 드라이버에 권장되며 사용자 지정 정의 형식을 구현하는 드라이버에 필요합니다. 프라이빗 형식의 파일을 전송하는 동안 사용할 올바른 파일 이름 확장명을 애플리케이션에 알릴 수 있습니다. 예를 들어 A. Datum Corporation이 파일을 새 형식으로 전송하는 WIA 드라이버를 만든 경우 회사는 "adc"의 확장을 지정할 수 있습니다. 이를 통해 애플리케이션은 해당 형식의 데이터를 파일로 전송하고 myfile.adc와 같은 파일 이름을 만들 수 있습니다. 이 이름은 새 확장명을 이해하는 다른 사용자에게 유용합니다.

WIA_IPA_FORMAT
PictureFormat

전송할 이미지의 현재 형식을 포함합니다.

애플리케이션이 수신할 이미지의 형식을 확인 하려면이 속성을 읽습니다. 애플리케이션은 형식을 설정하기 위해 이 속성을 씁니다. 이 속성은 WIA_IPA_TYMED 속성에 따라 달라집니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

디바이스를 단일 값으로만 설정할 수 있는 경우 WIA_PROP_LIST 형식을 만들고 유효한 값을 입력합니다.

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

다음 표에서는 이 속성에 유효한 상수를 나열합니다. 별표 *는 상수가 Windows Vista에서 지원되지 않음을 나타냅니다. ( IWiaItem 인터페이스를 통해서만 사용할 수 있습니다.) 이중 별표 **는 상수가 Windows Server 2003 또는 Windows Vista에서 지원되지 않음을 나타냅니다. V 기호는 상수가 Windows Vista 이상에서만 지원됨을 나타냅니다. ( IWiaItem2 인터페이스를 통해서만 사용할 수 있습니다.)

서식 Description
WiaAudFmt_AIFF AIFF 오디오 형식
WiaAudFmt_MP3 MP3 오디오 형식
WiaAudFmt_WAV WAV 오디오 형식
WiaAudFmt_WMA WMA 오디오 형식
WiaImgFmt_ASF** ASF 비디오 형식
WiaImgFmt_AVI** AVI 비디오 형식
WiaImgFmt_BMP 헤더 파일이 있는 Windows 비트맵
WiaImgFmt_CIFF* 카메라 이미지 파일 형식
WiaImgFmt_DPOF DPOF 인쇄 형식
WiaImgFmt_EMF 확장 Windows 메타파일
WiaImgFmt_EXEC 실행 파일
WiaImgFmt_EXIF 교환 가능한 파일 형식
WiaImgFmt_FLASHPIX FlashPix 형식
WiaImgFmt_GIF GIF 이미지 형식
WiaImgFmt_HTML HTML 형식
WiaImgFmt_ICO Windows 아이콘 파일 형식
WiaImgFmt_JBIGV JBIG(Joint Bi-level Image Experts Group) 형식입니다.
WiaImgFmt_JPEG JPEG 압축 형식
WiaImgFmt_JPEG2K JPEG 2000 압축 형식
WiaImgFmt_JPEG2KX JPEG 2000 압축 형식
WiaImgFmt_MEMORYBMP 헤더 파일이 없는 Windows 비트맵
WiaImgFmt_PDFAV PDF/A(ISO/CD 19005-1) 형식입니다.
WiaImgFmt_MPG** MPEG 비디오 형식
WiaImgFmt_PHOTOCD Eastman Kodak 파일 형식
WiaImgFmt_PICT Apple 파일 형식
WiaImgFmt_PNG W3C PNG 형식
WiaImgFmt_RAW 데이터 전송에 대한 원시 형식만
WiaImgFmt_RAWRGB 원시 RGB 형식
WiaImgFmt_RTF 서식 있는 텍스트 파일 형식
WiaImgFmt_SCRIPT 스크립트 파일
WiaImgFmt_TIFF TIFF(Tag Image File Format)
WiaImgFmt_TXT 텍스트 파일
WiaImgFmt_UNICODE16 유니코드 16비트 인코딩
WiaImgFmt_WMF Windows 메타파일
WiaImgFmt_XML XML 파일
WiaImgFmt_XPSV XPS 패키지 형식

 

참고:
이 속성이 WiaImgFmt_PDFA 또는 WiaImgFmt_XPS WIA_IPA_COMPRESSION WIA_COMPRESSION_NONE. 후자의 값은 압축 모드가 정의되지 않았으며 스캐너가 모드를 결정해야 했음을 의미합니다.

 
WIA_IPA_FULL_ITEM_NAME
PictureFullItemName

전체 항목 이름(경로 정보와 함께 항목 이름)을 포함합니다. 전체 항목 이름은 wiasCreateDrvItem 서비스 유틸리티 함수의 bstrFullItemName 매개 변수와 동일합니다. 애플리케이션은 현재 사용 중인 항목과 해당 항목이 항목 트리에 있는 위치를 확인하기 위해 이 속성을 읽습니다. 각 항목에는 고유한 이름이 있어야 합니다. 애플리케이션은 일반적으로 전체 항목 이름을 사용하여 항목 트리에서 항목을 검색합니다. WIA 서비스는 이 속성을 만들고 유지 관리합니다.

모든 WIA 2.0 항목에 필요합니다.

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

WIA_IPA_GAMMA_CURVES
PictureGammaCurves

이 속성은 나중에 사용하기 위해 예약되어 있으며 현재 구현되지 않습니다.

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

WIA_IPA_ICM_PROFILE_NAME
PictureIcmProfileName

이미지를 제대로 디코딩하는 데 필요한 ICM 프로필 이름을 포함합니다. 애플리케이션은 이미지를 처리할 때 사용할 ICM 프로필을 결정하기 위해 이 속성을 읽습니다. WIA 서비스는 드라이버 설치 파일의 ICMProfiles 항목에 따라 이 속성을 만들고 유지 관리합니다.

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

WIA_IPA_ITEM_CATEGORY
PictureItemCategory

Windows Vista 이상에서만 지원됩니다.

WIA 2.0 항목은 IWiaItem2 를 처리하거나 사용하는 방법을 정의하는 범주로 그룹화됩니다. 예를 들어 항목이 피더를 나타내는 경우 애플리케이션은 필수 문서 피더 속성을 포함하고 문서 피더처럼 작동해야 합니다. 항목이 완성된 파일을 나타내는 경우 WIA 2.0 애플리케이션은 데이터가 정적이며 디바이스에 있다고 가정하여 이러한 방식으로 처리해야 합니다. (각 항목에 대한 규칙은 개별 사양 문서에 정의됩니다.)

모든 WIA 2.0 항목에 필요합니다.

형식: VT_CLSID, 액세스: 읽기 전용, 유효한 값: 항목 범주 GUID

WIA_IPA_ITEM_FLAGS
PictureItemFlags

WIA 항목에 대한 설명 플래그를 포함합니다. 항목 플래그는 wiasCreateDrvItem 서비스 유틸리티 함수의 lObjectFlags 매개 변수에 있는 플래그와 동일합니다. WIA 서비스는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 항목의 설명 플래그 값을 확인 하려면이 속성을 읽습니다.

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

다음 표에는 이 속성에 유효한 플래그가 있습니다. 별표 *는 플래그가 Windows Vista 이상에서 지원되지 않음을 나타냅니다. ( IWiaItem 인터페이스를 통해서만 사용할 수 있습니다.) 이중 별표 **는 플래그가 Windows Server 2003 또는 Windows Vista 이상에서 지원되지 않음을 나타냅니다. V 기호는 플래그가 Windows Vista 이상에서만 지원됨을 나타냅니다. ( IWiaItem2 인터페이스를 통해서만 사용할 수 있습니다.)

플래그 정의
WiaItemTypeAnalyze* 이 항목은 IWiaItem::AnalyzeItem 메서드를 지원합니다(플랫폼 SDK 설명서에 설명됨). 이 항목은 자동 자식 항목 생성도 지원합니다. 이 기능은 지역 검색 또는 페이지 분해에 유용합니다.
WiaItemTypeAudio 이 항목은 오디오를 지원합니다. 이 플래그는 WiaItemTypeFile 플래그가 설정된 항목에만 유효합니다.
WiaItemTypeBurst* 폴더에만 해당합니다. 이 플래그는 이 폴더의 이미지가 연속 시간 순서로 촬영되었음을 나타냅니다.
WiaItemTypeDeleted 이 항목은 삭제를 위해 표시되었거나, 이 항목이 삭제되었거나, 이 항목이 없거나, 이 항목의 내용이 잘못되었습니다.
WiaItemTypeDocumentV 이 항목은 WIA_IPA_FORMAT 속성에 포함된 문서 형식 중 하나의 문서 파일입니다. (이러한 형식에는 .txt, .htm 및 .doc 파일과 같은 비이미지 파일에 대한 형식이 포함됩니다.
WiaItemTypeDevice 이 항목은 연결된 디바이스를 나타냅니다.
WiaItemTypeDisconnected 이 항목은 연결이 끊긴 디바이스를 나타냅니다.
WiaItemTypeFile 항목은 파일 전송을 지원합니다.
WiaItemTypeFolder 항목이 폴더입니다.
WiaItemTypeFree 항목이 초기화되지 않거나 삭제되었습니다.
WiaItemTypeGenerated 이 항목은 애플리케이션 또는 드라이버에 의해 생성되었습니다.
WiaItemTypeHasAttachments* 이 항목은 첨부 파일을 지원하며 현재 첨부 파일을 포함합니다.
WiaItemTypeHPanorama* 이 항목은 가로 파노라마 이미지를 나타냅니다. 이 플래그는 WiaItemTypeFolder 플래그가 설정된 항목에만 유효합니다.
WiaItemTypeImage 항목이 이미지 파일입니다. 이 플래그는 WiaItemTypeFile 플래그가 설정된 항목에만 유효합니다.
WiaItemTypeProgrammableDataSourceV 항목은 프로그래밍 가능한 데이터 원본이며 WIA_IPA_ITEM_CATEGORY 기반으로 하는 미리 정의된 구성 규칙 집합을 따릅니다.
WiaItemTypeRootV 이 항목은 디바이스에서 지원하는 모든 기능 항목의 부모인 루트 항목입니다.
WiaItemTypeStorage 이 플래그는 폴더 항목에 대한 추가 스토리지를 나타냅니다. WIA 드라이버는 이미지 및 폴더 측면에서 해당 항목을 지정합니다. 스토리지 항목의 특성(예: 남은 스토리지 공간, 쓰기 속도 또는 미디어 유형)을 설명하는 WIA 속성이 없습니다. 이 정보를 노출하는 공급업체별 속성을 추가할 수 있습니다. 이러한 속성은 인식하도록 작성된 애플리케이션 또는 확장에만 액세스할 수 있습니다.
WiaItemTypeTransfer 이 항목을 사용하여 데이터를 전송할 수 있습니다.
WiaItemTypeTwainCapabilityPassThrough 이 유형은 WIA 디바이스가 TWAIN 호환성 계층에서 TWAIN 기능 데이터를 받을 수 있음을 나타냅니다. 이 형식을 설정하면 TWAIN 호환성 계층에서 이해하지 못하는 모든 TWAIN 기능이WIA 드라이버에 전달됩니다. 루트 항목에 대해서만 유효합니다.
WiaItemTypeVideo** 이 항목은 스트리밍 비디오를 지원합니다.
WiaItemTypeVPanorama* 이 항목은 세로 파노라마 이미지를 나타냅니다. 이 플래그는 WiaItemTypeFolder 플래그가 설정된 항목에 대해서만 유효합니다.

 

이러한 플래그 중 일부는 이 표와 같이 항목 범주에 따라 WIA 2.0 항목에 필요하거나 선택 사항입니다.

항목 범주 필수 선택 사항
WIA_CATEGORY_ROOT WiaItemTypeRoot WiaItemTypeFolder WiaItemTypeDevice WiaItemTypeDisconnected
WIA_CATEGORY_FLATBED WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder(여러 검사 영역 항목이 지원되는 경우 이 플래그는 WIA_CATEGORY_FLATBED 루트 항목에 대해서만 선택 사항입니다.)
WIA_CATEGORY_FEEDER WIA_CATEGORY_FEEDER_FRONT WIA_CATEGORY_FEEDER_BACK WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder(WIA_CATEGORY_FEEDER_FRONT 및 WIA_CATEGORY_FEEDER_BACK 항목이 있는 경우 이 플래그는 WIA_CATEGORY_FEEDER 루트 항목에 대해서만 선택 사항입니다.
WIA_CATEGORY_FILM(루트) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile WiaItemTypeFolder 없음
WIA_CATEGORY_FILM(자식) WiaItemTypeProgrammableDataSource WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeFile 없음
WIA_CATEGORY_FOLDER WiaItemTypeStorage WiaItemTypeFolder WiaItemTypeDeleted
WIA_CATEGORY_FINISHED_FILE WiaItemTypeFile WiaItemTypeTransfer WiaItemTypeImage WiaItemTypeAudio WiaItemTypeDeleted

 

WIA_IPA_ITEM_NAME
PictureItemName

항목 이름을 포함합니다. 애플리케이션은 현재 사용 중인 항목을 결정하기 위해 이 속성을 읽습니다. 각 항목에는 고유한 이름이 있습니다. WIA 서비스는 이 속성을 만들고 유지 관리합니다.

모든 WIA 2.0 항목에 필요합니다.

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

WIA_IPA_ITEM_SIZE
PictureItemSize

항목과 연결된 데이터의 현재 크기(바이트)를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

포함은 전송되는 데이터의 총 크기입니다. 이 값이 0이면 미니드라이버에 데이터의 정확한 크기에 대한 정보가 없음을 의미합니다. 압축된 데이터에 일반적입니다. 애플리케이션은 이 값을 읽어 인수가 발생하기 전에 획득 크기를 결정합니다. WIA 서비스는 데이터 전송을 위해 메모리를 할당하는 데 도움이 되도록 이 속성을 읽습니다. 자세한 내용은 속성이 0으로 설정되고 TYMED가 파일 전송을 위해 구성된 경우 WIA 서비스가 WIA 미니 드라이버에 대한 메모리를 할당하지 않는 경우 WIA 애플리케이션으로 데이터 전송을 참조하세요.

모든 전송 사용 WIA 2.0 항목에 필요합니다.

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

WIA_IPA_ITEM_TIME
PictureItemTime

이미지가 원래 캡처된 시간을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다. 이 속성은 SYSTEMTIME 구조의 형태로 8개의 WORD 값 벡터로 보고되어야 합니다(플랫폼 SDK 설명서에 설명됨).

모든 WIA 2.0 항목에 대한 선택 사항입니다.

형식: VT_UI2 | VT_VECTOR Access: 읽기/쓰기 또는 읽기 전용, 유효한 값: WIA_PROP_NONE

WIA_IPA_ITEMS_STORED
PictureItemItemsStored

Windows Vista 이상에서만 지원됩니다.

WIA_CATEGORY_FOLDER 항목에 저장되는 항목 수를 지정합니다.

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

WIA_IPA_MIN_BUFFER_SIZE
PictureMinBufferSize

데이터 전송에 사용되는 최소 버퍼 크기를 지정합니다. 콜백 메커니즘을 통해 데이터 전송을 수행하는 경우 속성 값은 64KB만큼 작을 수 있습니다. 그러나 전송이 파일인 경우 속성 값은 한 번에 한 페이지의 데이터를 전송하는 데 필요한 바이트 수입니다. 미니 드라이버는 이 WIA 속성을 만들고 유지 관리합니다.

모든 전송 사용 WIA 2.0 항목에 대한 선택 사항입니다.

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

WIA_IPA_NUMBER_OF_LINES
PictureNumberOfLines

이미지에 포함된 선 수(이미지의 세로 높이(픽셀)를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

모든 WIA 2.0 항목에 대한 선택 사항입니다.

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

WIA_IPA_PIXELS_PER_LINE
PicturePixelsPerLine

이미지의 각 줄에 있는 픽셀 수(이미지 너비(픽셀))를 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

모든 WIA 2.0 항목에 대한 선택 사항입니다.

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

WIA_IPA_PLANAR
PicturePlanar

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

이미지 데이터 압축 옵션을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 이 속성을 읽어 이미지 압축 옵션을 결정하거나 현재 이미지 압축 옵션을 설정합니다.

형식: VT_I4; 액세스: 읽기/쓰기; 유효한 값: WIA_PROP_LIST. 디바이스를 단일 값으로만 설정할 수 있는 경우 WIA_PROP_LIST 형식을 만들고 유효한 값을 배치합니다.

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

정의
WIA_PACKED_PIXEL 이미지 데이터는 압축된 픽셀 형식입니다.
WIA_PLANAR 이미지 데이터는 평면 형식입니다.

 

WIA_IPA_PREFERRED_FORMAT
PicturePreferredFormat

이 미니드라이버에서 전송하는 이미지의 기본 형식을 포함합니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

모든 전송 사용 WIA 2.0 항목에 필요합니다.

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

WIA_IPA_PROP_STREAM_COMPAT_ID
PicturePropStreamCompatId

디바이스 속성 값 집합을 나타내는 CLSID를 지정합니다. 디바이스 드라이버가 이 기능을 구현하는 경우 애플리케이션은 이 속성을 사용하여 디바이스가 값 집합을 지원하는지 확인합니다.

형식: CLSID, 액세스: 읽기 전용, 유효한 값: WIA_PROP_LIST

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

정의
WiaImgFmt_BMP 헤더 파일이 있는 MicrosoftWindows 비트맵
WiaImgFmt_EMF 확장 Windows 메타파일
WiaImgFmt_EXIF 교환 가능한 파일 형식
WiaImgFmt_FLASHPIX FlashPix 형식
WiaImgFmt_GIF GIF 이미지 형식
WiaImgFmt_ICO Windows 아이콘 파일 형식
WiaImgFmt_JPEG JPEG 압축 형식
WiaImgFmt_PHOTOCD Eastman Kodak 파일 형식
WiaImgFmt_PNG W3C PNG 형식
WiaImgFmt_MEMORYBMP 헤더 파일이 없는 Windows 비트맵
WiaImgFmt_TIFF TIFF(Tag Image File Format)
WiaImgFmt_WMF Windows 메타파일

 

WIA_IPA_RAW_BITS_PER_CHANNEL
PictureRawBitsPerChannel

Windows Vista 이상에서만 지원됩니다.

각 채널의 비트 수를 포함합니다. 이 속성은 채널이 있는 만큼의 BYTE 값의 벡터로 보고되어야 합니다. 여기서 첫 번째 BYTE는 첫 번째 채널의 비트 수, 두 번째 바이트는 두 번째 채널의 비트 수에 해당합니다. WIA_IPA_CHANNELS_PER_PIXEL 따라 채널이 있는 만큼 많은 항목이 있어야 합니다. 드라이버는 애플리케이션이 WiaImgFmt_RAW 전환할 때 해당 속성을 설정합니다. 잘 알려진 하위 형식의 경우 WIA_IPA_RAW_SUBTYPE 아래 표에 나열된 항목이 많이 있습니다.

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

WIA_IPA_REGION_TYPE
PictureRegionType

이 속성은 나중에 사용하기 위해 에 의해 예약되며 현재 구현되지 않습니다.

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

WIA_IPA_SUPPRESS_PROPERTY_PAGE
PictureSuppressPropertyPage

디바이스의 항목에 대한 일반 속성 페이지를 표시하지 않을지 여부를 지정합니다.

이 속성은 Windows XP 이상에서 사용할 수 있습니다.

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

다음 표에는 이 속성에 유효한 상수가 있습니다. 별표 *는 상수가 Windows Vista 이상에서 유효하지 않음을 나타냅니다. ( IWiaItem 인터페이스를 통해서만 사용할 수 있습니다.)

상수 Description
WIA_PROPPAGE_CAMERA_ITEM_GENERAL* 카메라의 일반 항목 속성 페이지를 표시하지 않습니다.
WIA_PROPPAGE_SCANNER_ITEM_GENERAL 스캐너의 일반 항목 속성 페이지를 표시하지 않습니다.

 

WIA_IPA_TYMED
PictureTymed

이 속성에는 전송 메서드 설정이 포함됩니다. 미니 드라이버는 이 속성을 만들고 유지 관리합니다.

애플리케이션은 이 속성을 읽어 미니드라이버의 데이터 전송 방법을 확인합니다.

모든 전송 사용 WIA 2.0 항목에 필요합니다.

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

다음 표에는 이 속성에 유효한 상수가 있습니다. 별표 *는 Windows Vista 이상에서 유효하지 않은 상수를 나타냅니다. ( IWiaItem 인터페이스를 통해서만 사용할 수 있습니다.)

전송 유형 Description
TYMED_CALLBACK* 대역에서 메모리로 이미지를 전송합니다.
TYMED_MULTIPAGE_CALLBACK* 여러 이미지를 대역 내 메모리로 전송합니다.
TYMED_FILE 이미지를 파일로 전송합니다.
TYMED_MULTIPAGE_FILE 이미지를 파일로 전송합니다.

 

WIA_IPA_UPLOAD_ITEM_SIZE
PictureItemUploadItemSize

Windows Vista 이상에서만 지원됩니다.

항목에 대해 업로드할 바이트 수를 지정합니다.

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

요구 사항

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