QPx_AcqSelectDevice
| 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 |
| qpx_AcqICScannerProtocol | 8 | Mac OS Image Capture Scanner 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 |