IWiaDevMgr2::SelectDeviceDlgID 메서드
사용자가 이미지 획득을 위해 하드웨어 디바이스를 선택할 수 있는 대화 상자를 표시합니다.
구문
HRESULT SelectDeviceDlgID(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[out, retval] BSTR *pbstrDeviceID
);
매개 변수
-
hwndParent [in]
-
형식: HWND
디바이스 선택 대화 상자의 부모 창을 지정합니다.
-
lDeviceType [in]
-
형식: LONG
사용할 WIA 2.0 디바이스 유형을 지정합니다. 가능한 값 목록은 WIA 디바이스 유형 지정자를 참조하세요.
-
lFlags [in]
-
형식: LONG
대화 상자의 동작을 지정합니다. 값은 다음 중 하나일 수 있습니다.
-
0
-
기본 동작을 사용합니다.
-
WIA_SELECT_DEVICE_NODEFAULT
-
일치하는 디바이스가 하나만 있어도 대화 상자를 표시합니다.
pbstrDeviceID [out, retval]
형식: BSTR*
디바이스의 식별자 문자열을 수신하는 문자열에 대한 포인터입니다.
반환 값
형식: HRESULT
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
디바이스가 성공적으로 선택되었습니다. |
|
사용자가 대화 상자를 취소했습니다. |
|
lDeviceType 매개 변수에 지정된 사양과 일치하는 WIA 2.0 하드웨어 디바이스가 없습니다. |
설명
이 메서드는 사용자가 이미지 획득을 위해 WIA 2.0 디바이스를 선택할 수 있도록 디바이스 선택 대화 상자를 만들고 표시합니다. 디바이스가 성공적으로 선택되면 IWiaDevMgr2::SelectDeviceDlgID 메서드는 해당 pbstrDeviceID 매개 변수를 통해 식별자 문자열을 애플리케이션에 전달합니다.
애플리케이션은 lDeviceType 매개 변수를 통해 디바이스 유형을 지정하여 사용자에게 표시되는 디바이스를 특정 형식으로 제한할 수 있습니다. 하나의 디바이스만 사양을 충족하는 경우 IWiaDevMgr2::SelectDeviceDlgID 는 디바이스 선택 대화 상자를 표시하지 않습니다. 대신 대화 상자를 표시하지 않고 디바이스의 식별자 문자열을 애플리케이션에 전달합니다. 이 동작을 재정의하고 lFlags 매개 변수의 값으로 WIA_SELECT_DEVICE_NODEFAULT 전달하여 IWiaDevMgr2::SelectDeviceDlgID를 강제로 대화 상자를 표시할 수 있습니다. 둘 이상의 WIA 2.0 디바이스가 사양과 일치하는 경우 사용자가 선택할 수 있도록 일치하는 모든 디바이스가 선택디바이스 대화 상자에 표시됩니다.
참고
애플리케이션은 파일 메뉴의 스캐너에서라는 메뉴 항목을 통해 디바이스 및 이미지 선택을 사용할 수 있도록 하는 것이 좋습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|