IWiaItem::D eviceDlg 메서드(wia_xp.h)

IWiaItem::D eviceDlg 메서드는 애플리케이션에서 이미지 획득을 준비하기 위해 사용자에게 대화 상자를 표시하는 데 사용됩니다.

구문

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

매개 변수

[in] hwndParent

형식: HWND

대화 상자의 부모 창 핸들입니다.

[in] lFlags

형식: LONG

대화 상자의 작업을 제어하는 플래그 집합을 지정합니다. 다음 값으로 설정할 수 있습니다.

플래그	의미
0	기본 동작
WIA_DEVICE_DIALOG_SINGLE_IMAGE	디바이스 이미지 획득 대화 상자에서 이미지 선택을 단일 이미지로 제한합니다.
WIA_DEVICE_DIALOG_USE_COMMON_UI	공급업체에서 제공하는 UI 대신 시스템 UI(사용 가능한 경우)를 사용합니다. 시스템 UI를 사용할 수 없는 경우 공급업체 UI가 사용됩니다. 두 UI를 모두 사용할 수 없는 경우 함수는 E_NOTIMPL 반환합니다.

[in] lIntent

형식: LONG

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

참고 이 메서드는 모든 WIA_INTENT_IMAGE_* 이미지 의도를 무시합니다.

 

[out] plItemCount

형식: LONG*

ppIWiaItem 매개 변수로 표시된 배열의 항목 수를 받습니다.

[out] ppIWiaItem

형식: IWiaItem***

IWiaItem 인터페이스에 대한 포인터 배열의 주소를 받습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 애플리케이션이 이미지 획득에 필요한 모든 정보를 수집하는 데 사용하는 대화 상자를 사용자에게 표시합니다. instance 경우 이 대화 상자를 사용하면 사용자가 카메라에서 다운로드할 이미지를 선택할 수 있습니다. 스캐너를 사용하는 경우 밝기 및 대비와 같은 이미지 스캔 속성을 지정하는 데도 사용됩니다.

이 메서드가 반환된 후 애플리케이션은 IWiaDataTransfer 인터페이스를 사용하여 이미지를 가져올 수 있습니다.

애플리케이션은 ppIWiaItem 매개 변수를 통해 수신하는 인터페이스 포인터 배열의 각 요소에 대해 IUnknown::Release 메서드를 호출해야 합니다. 또한 애플리케이션은 CoTaskMemFree를 사용하여 배열을 해제해야 합니다.

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

요구 사항

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