IPhotoAcquireDeviceSelectionDialog::DoModal method (photoacquire.h)

  • Article

The DoModal method displays a device selection dialog box. The function returns when the user selects a device using the modal dialog box.

Syntax

HRESULT DoModal(
  [in]  HWND                         hWndParent,
  [in]  DWORD                        dwDeviceFlags,
  [out] BSTR                         *pbstrDeviceId,
  [out] DEVICE_SELECTION_DEVICE_TYPE *pnDeviceType
);

Parameters

[in] hWndParent

Handle to a parent window.

[in] dwDeviceFlags

Double word value containing a combination of device flags that indicate which type of devices to display. The device flags may be a combination of any of the following:

Flag Description
DSF_WPD_DEVICES Show devices of type Windows Portable Devices (WPD).
DSF_WIA_CAMERAS Show cameras of type Windows Image Acquisition (WIA).
DSF_WIA_SCANNERS Show scanners of type Windows Image Acquisition (WIA).
DSF_STI_DEVICES Show devices of type Still Image Architecture (STI).
DSF_FS_DEVICES Show removable storage devices, such as CD drives or card readers.
DSF_DV_DEVICES Show digital video camera devices.
DSF_ALL_DEVICES Show all devices.
DSF_SHOW_OFFLINE Show devices that are offline. Not supported by all device types.

[out] pbstrDeviceId

Pointer to a string containing the ID of the selected device.

[out] pnDeviceType

Pointer to the DEVICE_SELECTION_DEVICE_TYPE of the selected device.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.

Requirements

Requirement Value
Target Platform Windows
Header photoacquire.h
Library PhotoAcquireUID.lib

See also

DEVICE_SELECTION_DEVICE_TYPE

IPhotoAcquireDeviceSelectionDialog Interface