IWiaItem2::D eviceDlg 메서드

이미지 획득을 준비하기 위해 사용자에게 대화 상자를 표시합니다.

구문

HRESULT DeviceDlg(
  [in]      LONG      lFlags,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in, out] BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppIWiaItem2
);

매개 변수

lFlags [in]

형식: LONG

대화 상자의 작업을 제어하는 플래그 집합을 지정합니다. 값은 기본 동작을 나타내는 0이거나 WiaFlag에 설명된 WIA_DEVICE_DIALOG 플래그 중 하나일 수 있습니다.

hwndParent [in]

형식: HWND

부모 창에 대한 핸들입니다.

bstrFolderName [in]

형식: BSTR

파일을 전송할 폴더 이름을 지정합니다.

bstrFilename [in]

형식: BSTR

템플릿 파일 이름을 지정합니다.

plNumFiles [in]

형식: LONG*

ppbstrFilePaths 배열의 항목 수에 대한 포인터입니다.

ppbstrFilePaths [in, out]

형식: BSTR**

스캔한 파일의 경로 배열에 대한 포인터의 주소입니다. IWiaItem2::D eviceDlg가 호출되기 전에 크기가 0인 배열을 가리키도록 포인터를 초기화합니다.

ppIWiaItem2 [in, out]

형식: IWiaItem2**

IWiaItem2 인터페이스에 대한 포인터 배열의 주소입니다.

반환 값

형식: HRESULT

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

설명

이 메서드는 애플리케이션이 이미지 획득에 필요한 모든 정보를 수집하는 데 사용하는 대화 상자를 사용자에게 표시합니다. 또한 밝기 및 대비와 같은 이미지 검사 속성을 지정하는 데도 사용됩니다.

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

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

요구 사항

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