QPix Command Reference
![]() |
![]() ![]() |
QPx_AcqSelectDevice(acqProtocol; deviceName; selectionOptions):error | |||
![]() |
acqProtocol | Longint | Acquisition protocol ID |
![]() |
deviceName | Text | Device name |
![]() |
selectionOptions | Longint | Selection options (optional) |
![]() |
error | Longint | Error result |
Displays the acquisition protocol and device selection dialog.
Parameter acqProtocol specifies the protocol to be initially selected in the dialog, and receives the ID of the protocol that was selected by the user. It can be one of the acquisition protocol ID 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 to be initially selected in the dialog, and receives the name of the device that was selected by the user.
Parameter selectionOptions is optional and can be used to specify options for the selection dialog. Currently it can only accept one value, the qpx_AcqRestrictToProtocol constant.
If selectionOptions equals zero or is ommited, QPix allows selection of both acquisition protocol and device. If selectionOptions equals qpx_AcqRestrictToProtocol, QPix displays a dialog where only devices of the protocol specified with acqProtocol are listed.
Related commands
QPx_AcqTestProtocol | Tests if an acquisition protocol is available on the current machine and OS |
QPx_AcqGetDeviceList | Returns all devices that are available through a specific acquisition protocol. |