LXE MX3-CE, Справочное руководство

Страница: 132 / 166

120 Appendix C API Calls
MX3-CE Reference Guide E-EQ-MX3CERG-E
LXEScannerSetWindow
#define WM_LXE_SCANDONE 0x600
#define WM_LXE_SCANERR 0x601
#define WM_LXE_SCANFULL 0x602
int LXEScannerSetWindow(HWND window);
This function attaches an application window to the scanner driver. When a scan occurs, the
scanner driver then sends a Windows message to the application window, indicating that a scan
has occurrred.
The message WM_LXE_SCANDONE or WM_LXE_SCANFULL indicates the scan is complete,
and the data may be read using standard Win32 file/device API calls, opening the scanner device.
The message WM_LXE_SCANERR indicates a configuration error which prevents the scanner
from processing data correctly. There is no message generated on a failed scan. Other messages
may be added to this list in the future, as new capabilities emerge.
This function may be called up to 8 times. All 8 window handles are sent the message when the
events occur. The window handle is tested for validity before sending the message; invalid
handles are removed from the list. Thus, the application is not required to clean up the
connection.
This function returns 0 on error, or 1 on success. GetLastError() may be used to get a detailed
error message.
Note: WM_LXE_SCANFULL is an updated replacement for WM_LXE_SCANDONE.
WM_LXE_SCANDONE is retained in this API for backwards compatibility.