IWiaDevMgr::GetImageDlg 메서드(wia_xp.h)

IWiaDevMgr::GetImageDlg 메서드는 사용자가 WIA(Windows 이미지 획득) 디바이스에서 이미지를 획득하고 지정된 파일에 이미지를 쓸 수 있는 하나 이상의 대화 상자를 표시합니다. 이 메서드는 IWiaDevMgr::SelectDeviceDlg 의 기능을 결합하여 단일 API 호출 내에서 이미지 획득을 완전히 캡슐화합니다.

구문

HRESULT GetImageDlg(
  [in]      HWND     hwndParent,
  [in]      LONG     lDeviceType,
  [in]      LONG     lFlags,
  [in]      LONG     lIntent,
  [in]      IWiaItem *pItemRoot,
  [in]      BSTR     bstrFilename,
  [in, out] GUID     *pguidFormat
);

매개 변수

[in] hwndParent

형식: HWND

이미지 가져오기 대화 상자를 소유하는 창의 핸들입니다.

[in] lDeviceType

형식: LONG

사용할 WIA 디바이스 유형을 지정합니다. StiDeviceTypeDefault, StiDeviceTypeScanner 또는 StiDeviceTypeDigitalCamera로 설정됩니다.

[in] lFlags

형식: LONG

대화 상자 동작을 지정합니다. 다음 값으로 설정할 수 있습니다.

플래그	의미
0	기본 동작
WIA_SELECT_DEVICE_NODEFAULT	이 메서드가 디바이스 선택 대화 상자를 표시하도록 합니다. 자세한 내용은 이 참조 페이지의 설명 섹션을 참조하세요.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	디바이스 이미지 획득 대화 상자에서 이미지 선택을 단일 이미지로 제한합니다.
WIA_DEVICE_DIALOG_USE_COMMON_UI	공급업체에서 제공하는 UI 대신 시스템 UI(사용 가능한 경우)를 사용합니다. 시스템 UI를 사용할 수 없는 경우 공급업체 UI가 사용됩니다. 두 UI를 모두 사용할 수 없는 경우 함수는 E_NOTIMPL 반환합니다.

[in] lIntent

형식: LONG

이미지가 나타낼 데이터 형식을 지정합니다. 이미지 의도 값 목록은 이미지 의도 상수를 참조하세요.

[in] pItemRoot

형식: IWiaItem*

IWiaDevMgr::CreateDevice에서 반환된 IWiaItem 개체의 계층 트리 인터페이스에 대한 포인터입니다.

[in] bstrFilename

형식: BSTR

이미지 데이터가 기록되는 파일의 이름을 지정합니다.

[in, out] pguidFormat

형식: GUID*

입력에서 에는 사용할 형식을 지정하는 GUID에 대한 포인터가 포함됩니다. 출력에서 은 사용된 형식을 보유합니다. 기본 형식을 사용하도록 IID_NULL 전달합니다.

반환 값

형식: HRESULT

IWiaDevMgr::GetImageDlg 는 사용자가 디바이스 선택 또는 이미지 획득 대화 상자를 취소하는 경우 S_FALSE 반환하고, 현재 WIA 디바이스를 사용할 수 없는 경우 WIA_S_NO_DEVICE_AVAILABLE, UI를 사용할 수 없는 경우 E_NOTIMPL, 데이터가 성공적으로 전송되었는지 S_OK.

IWiaDevMgr::GetImageDlg 는 오류 코드에 지정된 값 또는 지정된 값 이외의 이유로 실패하는 경우 표준 COM 오류를 반환합니다.

설명

이 메서드를 호출하면 사용자가 이미지를 가져올 수 있는 대화 상자가 표시됩니다. IWiaDevMgr::SelectDeviceDlg 메서드에서 만든 디바이스 선택 대화 상자를 표시할 수도 있습니다.

애플리케이션이 pItemRoot 매개 변수 값에 대해 NULL을 전달하는 경우 IWiaDevMgr::GetImageDlg는 사용자가 WIA 입력 디바이스를 선택할 수 있는 디바이스 선택 대화 상자를 표시합니다. 애플리케이션이 pItemRoot 매개 변수를 통해 디바이스의 항목 트리에 대한 포인터를 전달하여 WIA 입력 디바이스를 지정하는 경우 IWiaDevMgr::GetImageDlg 는 디바이스 선택 대화 상자를 표시하지 않습니다. 대신 지정된 입력 디바이스를 사용하여 이미지를 가져옵니다.

디바이스 선택 대화 상자를 사용하는 경우 애플리케이션은 WIA 입력 디바이스 유형을 지정할 수 있습니다. 이렇게 하려면 pItemRoot 매개 변수를 NULL 로 설정하고 lDeviceType 매개 변수를 통해 적절한 상수를 전달해야 합니다. 지정된 유형의 디바이스가 둘 이상 있는 경우 IWiaDevMgr::GetImageDlg 에 디바이스 선택 대화 상자가 표시되어 사용자가 사용할 디바이스를 선택할 수 있습니다.

IWiaDevMgr::GetImageDlg에서 일치하는 디바이스를 하나만 찾으면 디바이스 선택 대화 상자가 표시되지 않습니다. 대신 일치하는 디바이스를 선택합니다. 이 동작을 재정의하고 lFlags 매개 변수의 값으로 WIA_SELECT_DEVICE_NODEFAULT 전달하여 IWiaDevMgr::GetImageDlg에서 디바이스 선택 대화 상자를 표시하도록 강제할 수 있습니다.

애플리케이션은 파일 메뉴의 스캐너 또는 카메라에서라는 메뉴 항목을 통해 디바이스 및 이미지를 선택할 수 있도록 하는 것이 좋습니다.

대화 상자에는 고유한 파일 이름으로 파일을 저장할 수 있는 bstrFilename 폴더에 대한 충분한 권한이 있어야 합니다. 폴더에는 사용자 데이터가 포함되어 있으므로 ACL(액세스 제어 목록)으로도 보호해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wia_xp.h(Wia.h 포함)
라이브러리	Wiaguid.lib
DLL	Wiaservc.dll