gdi32/tests: Fix tests on NT4.
[wine] / dlls / twain_32 / TWAIN
1 Requirements to be a TWAIN-Compliant Source
2 Requirements
3 TWAIN-compliant Sources must support the following:
4 Operations
5 ----------
6 DG_CONTROL / DAT_CAPABILITY / MSG_GET
7 DG_CONTROL / DAT_CAPABILITY / MSG_GETCURRENT
8 DG_CONTROL / DAT_CAPABILITY / MSG_GETDEFAULT
9 DG_CONTROL / DAT_CAPABILITY / MSG_RESET
10 DG_CONTROL / DAT_CAPABILITY / MSG_SET
11 DG_CONTROL / DAT_EVENT / MSG_PROCESSEVENT
12 DG_CONTROL / DAT_IDENTITY / MSG_GET
13 DG_CONTROL / DAT_IDENTITY / MSG_OPENDS
14 DG_CONTROL / DAT_IDENTITY / MSG_CLOSEDS
15 DG_CONTROL / DAT_PENDINGXFERS / MSG_ENDXFER
16 DG_CONTROL / DAT_PENDINGXFERS / MSG_GET
17 DG_CONTROL / DAT_PENDINGXFERS / MSG_RESET
18 DG_CONTROL / DAT_SETUPMEMXFER / MSG_GET
19 DG_CONTROL / DAT_STATUS / MSG_GET
20 DG_CONTROL / DAT_USERINTERFACE / MSG_DISABLEDS
21 DG_CONTROL / DAT_USERINTERFACE / MSG_ENABLEDS
22 DG_CONTROL / DAT_XFERGROUP / MSG_GET
23 DG_IMAGE / DAT_IMAGEINFO / MSG_GET
24 DG_IMAGE / DAT_IMAGELAYOUT / MSG_GET
25 DG_IMAGE / DAT_IMAGELAYOUT / MSG_GETDEFAULT
26 DG_IMAGE / DAT_IMAGELAYOUT / MSG_RESET
27 DG_IMAGE / DAT_IMAGELAYOUT / MSG_SET
28 DG_IMAGE / DAT_IMAGEMEMXFER / MSG_GET
29 DG_IMAGE / DAT_IMAGENATIVEXFER / MSG_GET
30
31 Capabilities
32 ------------
33 Every Source must support all five DG_CONTROL / DAT_CAPABILITY operations on:
34 CAP_XFERCOUNT
35 Every Source must support DG_CONTROL / DAT_CAPABILITY MSG_GET on:
36 CAP_SUPPORTEDCAPS
37 CAP_UICONTROLLABLE
38 Sources that supply image information must support DG_CONTROL / DAT_CAPABILITY /
39 MSG_GET, MSG_GETCURRENT, MSG_GETDEFAULT on:
40 ICAP_COMPRESSION
41 ICAP_PLANARCHUNKY
42 ICAP_PHYSICALHEIGHT
43 ICAP_PHYSICALWIDTH
44 ICAP_PIXELFLAVOR
45 Sources that supply image information must support DG_CONTROL / DAT_CAPABILITY /
46 MSG_GET, MSG_GETCURRENT, MSG_GETDEFAULT, MSG_RESET and MSG_SET on:
47 ICAP_BITDEPTH
48 ICAP_BITORDER
49 ICAP_PIXELTYPE
50 ICAP_UNITS
51 ICAP_XFERMECH
52 ICAP_XRESOLUTION
53 ICAP_YRESOLUTION
54 All Sources must implement the advertised features supported by their devices. They must
55 make these features available to applications via the TWAIN protocol. For example, a Source
56 that's connected to a device that has an ADF must support DG_CONTROL /
57 DAT_CAPABILITY / MSG_GET, MSG_GETCURRENT, MSG_GETDEFAULT on:
58 CAP_FEEDERENABLED
59 CAP_FEEDERLOADED
60 and DG_CONTROL / DAT_CAPABILITY / MSG_GET, MSG_GETCURRENT,
61 MSG_GETDEFAULT, MSG_RESET and MSG_SET on:
62 CAP_AUTOFEED
63 If the ADF also supports ejecting and rewinding of pages then the Source should also support
64 DG_CONTROL / DAT_CAPABILITY / MSG_GET, MSG_GETCURRENT,
65 MSG_GETDEFAULT, MSG_RESET and MSG_SET on:
66 CAP_CLEARPAGE
67 CAP_REWINDPAGE
68
69
70 *******************************************************************************
71
72 From Application to Source Manager (Control Information)
73
74 Data Group              Data Argument Type      Message
75 DG_CONTROL              DAT_IDENTITY            MSG_CLOSEDS
76                                                 MSG_GETDEFAULT
77                                                 MSG_GETFIRST
78                                                 MSG_GETNEXT
79                                                 MSG_OPENDS
80                                                 MSG_USERSELECT
81 DG_CONTROL              DAT_PARENT              MSG_CLOSEDSM
82                                                 MSG_OPENDSM
83 DG_CONTROL              DAT_STATUS              MSG_GET
84
85 From Application to Source (Control Information)
86 Data Group              Data Argument Type      Message
87 DG_CONTROL              DAT_CAPABILITY          MSG_GET
88                                                 MSG_GETCURRENT
89                                                 MSG_GETDEFAULT
90                                                 MSG_QUERYSUPPORT
91                                                 MSG_RESET
92                                                 MSG_SET
93 DG_CONTROL              DAT_CUSTOMDSDATA        MSG_GET
94                                                 MSG_SET
95 DG_CONTROL              DAT_FILESYSTEM          MSG_AUTOMATICCAPTURE
96                                                 DIRECTORY
97                                                 MSG_CHANGEDIRECTORY
98                                                 MSG_COPY
99                                                 MSG_CREATEDIRECTORY
100                                                 MSG_DELETE
101                                                 MSG_FORMATMEDIA
102                                                 MSG_GETCLOSE
103                                                 MSG_GETFIRSTFILE
104                                                 MSG_GETINFO
105                                                 MSG_GETNEXTFILE
106                                                 MSG_RENAME
107 DG_CONTROL              DAT_EVENT               MSG_PROCESSEVENT
108 DG_CONTROL              DAT_PASSTHRU            MSG_PASSTHRU
109 DG_CONTROL              DAT_PENDINGXFERS        MSG_ENDXFER
110                                                 MSG_GET
111                                                 MSG_RESET
112                                                 MSG_STOPFEEDER
113 DG_CONTROL              DAT_SETUPFILEXFER       MSG_GET
114                                                 MSG_GETDEFAULT
115                                                 MSG_RESET
116                                                 MSG_SET
117 DG_CONTROL              DAT_SETUPFILEXFER2      MSG_GET
118                                                 MSG_GETDEFAULT
119                                                 MSG_RESET
120                                                 MSG_SET
121 DG_CONTROL              DAT_SETUPMEMXFER        MSG_GET
122 DG_CONTROL              DAT_STATUS              MSG_GET
123 DG_CONTROL              DAT_USERINTERFACE       MSG_DISABLEDS
124                                                 MSG_ENABLEDS
125                                                 MSG_ENABLEDSUIONLY
126 DG_CONTROL              DAT_XFERGROUP           MSG_GET
127                                                 MSG_SET
128
129 From Application to Source (Image Information)
130 Data Group              Data Argument Type      Message
131 DG_IMAGE                DAT_CIECOLOR            MSG_GET
132 DG_IMAGE                DAT_EXTIMAGEINFO        MSG_GET
133 DG_IMAGE                DAT_GRAYRESPONSE        MSG_RESET
134                                                 MSG_SET
135 DG_IMAGE                DAT_IMAGEFILEXFER       MSG_GET
136 DG_IMAGE                DAT_IMAGEINFO           MSG_GET
137 DG_IMAGE                DAT_IMAGELAYOUT         MSG_GET
138                                                 MSG_GETDEFAULT
139                                                 MSG_RESET
140                                                 MSG_SET
141 DG_IMAGE                DAT_IMAGEMEMXFER        MSG_GET
142 DG_IMAGE                DAT_IMAGENATIVEXFER     MSG_GET
143 DG_IMAGE                DAT_JPEGCOMPRESSION     MSG_GET
144                                                 MSG_GETDEFAULT
145                                                 MSG_RESET
146                                                 MSG_SET
147 DG_IMAGE                DAT_PALETTE8            MSG_GET
148                                                 MSG_GETDEFAULT
149                                                 MSG_RESET
150                                                 MSG_SET
151 DG_IMAGE                DAT_RGBRESPONSE         MSG_RESET
152                                                 MSG_SET
153
154 From Application to Source (Audio Information)
155 Data Group              Data Argument Type      Message
156 DG_AUDIO                DAT_AUDIOFILEXFER       MSG_GET
157 DG_AUDIO                DAT_AUDIOINFO           MSG_GET
158 DG_AUDIO                DAT_AUDIONATIVEXFER     MSG_GET
159
160 From Source Manager to Source (Control Information)
161 Data Group              Data Argument Type      Message
162 DG_CONTROL              DAT_IDENTITY            MSG_CLOSEDS
163                                                 MSG_GET
164                                                 MSG_OPENDS
165
166 From Source to Application (Control Information via the Source Manager)
167 (Used by Windows Sources only)
168 Data Group              Data Argument Type      Message
169 DG_CONTROL              DAT_NULL                MSG_CLOSEDSOK
170                                                 MSG_CLOSEDSREQ
171                                                 MSG_DEVICEEVENT
172                                                 MSG_XFERREADY