IWiaDevMgr2::SelectDeviceDlgID method
Displays a dialog box that enables the user to select a hardware device for image acquisition.
Syntax
HRESULT SelectDeviceDlgID(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[out, retval] BSTR *pbstrDeviceID
);
Parameters
-
hwndParent [in]
-
Type: HWND
Specifies the parent window of the Select Device dialog box.
-
lDeviceType [in]
-
Type: LONG
Specifies which type of WIA 2.0 device to use. See WIA Device Type Specifiers for a list of possible values.
-
lFlags [in]
-
Type: LONG
Specifies the behavior of the dialog box. The value can be one of the following.
-
0
-
Use the default behavior.
-
WIA_SELECT_DEVICE_NODEFAULT
-
Display the dialog box even though there is only one matching device.
pbstrDeviceID [out, retval]
Type: BSTR*
Pointer to a string that receives the identifier string of the device.
Return value
Type: HRESULT
This method can return one of these values.
| Return code | Description |
|---|---|
|
Device was successfully selected. |
|
User canceled the dialog box. |
|
No WIA 2.0 hardware devices match the specifications given in the lDeviceType parameter. |
Remarks
This method creates and displays the Select Device dialog box so the user can select a WIA 2.0 device for image acquisition. If a device is successfully selected, the IWiaDevMgr2::SelectDeviceDlgID method passes its identifier string to the application through its pbstrDeviceID parameter.
The application can restrict the devices displayed to the user to particular types by specifying the device types through the lDeviceType parameter. If only one device meets the specification, IWiaDevMgr2::SelectDeviceDlgID does not display the Select Device dialog box. Instead it passes the device's identifier string to the application without displaying the dialog box. You can override this behavior and force IWiaDevMgr2::SelectDeviceDlgID to display the dialog box by passing WIA_SELECT_DEVICE_NODEFAULT as the value for the lFlags parameter. If more than one WIA 2.0 device matches the specification, all matching devices are displayed in the SelectDevice dialog box so the user may choose one.
Note
It is recommended that applications make device and image selection available through a menu item named From scanner on the File menu.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| Header |
|
| IDL |
|