QPx_AcqSelectDevice(acqProtocol; acqProtocol; acqProtocol):error
acqProtocol Longint Acquisition protocol ID
deviceName Text Device name
selectionOptions Longint Selection options (optional)
error Longint Error result

Display the device selection dialog for an acquisition protocol

Parameter acqProtocol specifies the protocol initially selected in the dialog, and receives the ID of the protocol selected by the user. It can be one of the acquisition protocol constants:

qpx_AcqTWAINProtocol 1 TWAIN identifier
qpx_AcqPictureTransferProtocol 2 Picture Transfer Protocol identifier
qpx_AcqVideoProtocol 4 Video acquisition protocol identifier

Parameter deviceName specifies the device initially selected in the dialog, and receives the name of the device selected by the user.

Parameter selectionOptions is optional and can be used to specify options. Currently it can only accept one value, the qpx_AcqRestrictToProtocol constant.

If selectionOptions is zero or omitted, QPix allows selection of both acquisition protocol and device. If selectionOptions equals qpx_AcqRestrictToProtocol, QPix displays a dialog where only devices of the preselected (specified by acqProtocol) protocol are listed.

Related commands

QPx_AcqTestProtocol Test the availability of an acquisition protocol
QPx_AcqGetDeviceList Get all devices available to an acquisition protocol