msi: Add more tests for the AppSearch action.
[wine] / dlls / gdi32 / driver.c
1 /*
2  * Graphics driver management functions
3  *
4  * Copyright 1994 Bob Amstadt
5  * Copyright 1996, 2001 Alexandre Julliard
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with this library; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
20  */
21
22 #include "config.h"
23 #include "wine/port.h"
24
25 #include <stdarg.h>
26 #include <string.h>
27 #include <stdio.h>
28 #include "windef.h"
29 #include "winbase.h"
30 #include "winreg.h"
31
32 #include "gdi_private.h"
33 #include "wine/unicode.h"
34 #include "wine/debug.h"
35
36 WINE_DEFAULT_DEBUG_CHANNEL(driver);
37
38 struct graphics_driver
39 {
40     struct graphics_driver *next;
41     struct graphics_driver *prev;
42     HMODULE                 module;  /* module handle */
43     unsigned int            count;   /* reference count */
44     DC_FUNCTIONS            funcs;
45 };
46
47 static struct graphics_driver *first_driver;
48 static struct graphics_driver *display_driver;
49
50 static CRITICAL_SECTION driver_section;
51 static CRITICAL_SECTION_DEBUG critsect_debug =
52 {
53     0, 0, &driver_section,
54     { &critsect_debug.ProcessLocksList, &critsect_debug.ProcessLocksList },
55       0, 0, { (DWORD_PTR)(__FILE__ ": driver_section") }
56 };
57 static CRITICAL_SECTION driver_section = { &critsect_debug, -1, 0, 0, 0, 0 };
58
59 /**********************************************************************
60  *           create_driver
61  *
62  * Allocate and fill the driver structure for a given module.
63  */
64 static struct graphics_driver *create_driver( HMODULE module )
65 {
66     struct graphics_driver *driver;
67
68     if (!(driver = HeapAlloc( GetProcessHeap(), 0, sizeof(*driver)))) return NULL;
69     driver->next   = NULL;
70     driver->prev   = NULL;
71     driver->module = module;
72     driver->count  = 1;
73
74     /* fill the function table */
75     if (module)
76     {
77 #define GET_FUNC(name) driver->funcs.p##name = (void*)GetProcAddress( module, #name )
78         GET_FUNC(AbortDoc);
79         GET_FUNC(AbortPath);
80         GET_FUNC(AlphaBlend);
81         GET_FUNC(AngleArc);
82         GET_FUNC(Arc);
83         GET_FUNC(ArcTo);
84         GET_FUNC(BeginPath);
85         GET_FUNC(BitBlt);
86         GET_FUNC(ChoosePixelFormat);
87         GET_FUNC(Chord);
88         GET_FUNC(CloseFigure);
89         GET_FUNC(CreateBitmap);
90         GET_FUNC(CreateDC);
91         GET_FUNC(CreateDIBSection);
92         GET_FUNC(DeleteBitmap);
93         GET_FUNC(DeleteDC);
94         GET_FUNC(DescribePixelFormat);
95         GET_FUNC(DeviceCapabilities);
96         GET_FUNC(Ellipse);
97         GET_FUNC(EndDoc);
98         GET_FUNC(EndPage);
99         GET_FUNC(EndPath);
100         GET_FUNC(EnumDeviceFonts);
101         GET_FUNC(ExcludeClipRect);
102         GET_FUNC(ExtDeviceMode);
103         GET_FUNC(ExtEscape);
104         GET_FUNC(ExtFloodFill);
105         GET_FUNC(ExtSelectClipRgn);
106         GET_FUNC(ExtTextOut);
107         GET_FUNC(FillPath);
108         GET_FUNC(FillRgn);
109         GET_FUNC(FlattenPath);
110         GET_FUNC(FrameRgn);
111         GET_FUNC(GdiComment);
112         GET_FUNC(GetBitmapBits);
113         GET_FUNC(GetCharWidth);
114         GET_FUNC(GetDCOrgEx);
115         GET_FUNC(GetDIBColorTable);
116         GET_FUNC(GetDIBits);
117         GET_FUNC(GetDeviceCaps);
118         GET_FUNC(GetDeviceGammaRamp);
119         GET_FUNC(GetICMProfile);
120         GET_FUNC(GetNearestColor);
121         GET_FUNC(GetPixel);
122         GET_FUNC(GetPixelFormat);
123         GET_FUNC(GetSystemPaletteEntries);
124         GET_FUNC(GetTextExtentExPoint);
125         GET_FUNC(GetTextMetrics);
126         GET_FUNC(IntersectClipRect);
127         GET_FUNC(InvertRgn);
128         GET_FUNC(LineTo);
129         GET_FUNC(MoveTo);
130         GET_FUNC(ModifyWorldTransform);
131         GET_FUNC(OffsetClipRgn);
132         GET_FUNC(OffsetViewportOrg);
133         GET_FUNC(OffsetWindowOrg);
134         GET_FUNC(PaintRgn);
135         GET_FUNC(PatBlt);
136         GET_FUNC(Pie);
137         GET_FUNC(PolyBezier);
138         GET_FUNC(PolyBezierTo);
139         GET_FUNC(PolyDraw);
140         GET_FUNC(PolyPolygon);
141         GET_FUNC(PolyPolyline);
142         GET_FUNC(Polygon);
143         GET_FUNC(Polyline);
144         GET_FUNC(PolylineTo);
145         GET_FUNC(RealizeDefaultPalette);
146         GET_FUNC(RealizePalette);
147         GET_FUNC(Rectangle);
148         GET_FUNC(ResetDC);
149         GET_FUNC(RestoreDC);
150         GET_FUNC(RoundRect);
151         GET_FUNC(SaveDC);
152         GET_FUNC(ScaleViewportExt);
153         GET_FUNC(ScaleWindowExt);
154         GET_FUNC(SelectBitmap);
155         GET_FUNC(SelectBrush);
156         GET_FUNC(SelectClipPath);
157         GET_FUNC(SelectFont);
158         GET_FUNC(SelectPalette);
159         GET_FUNC(SelectPen);
160         GET_FUNC(SetArcDirection);
161         GET_FUNC(SetBitmapBits);
162         GET_FUNC(SetBkColor);
163         GET_FUNC(SetBkMode);
164         GET_FUNC(SetDCBrushColor);
165         GET_FUNC(SetDCOrg);
166         GET_FUNC(SetDCPenColor);
167         GET_FUNC(SetDIBColorTable);
168         GET_FUNC(SetDIBits);
169         GET_FUNC(SetDIBitsToDevice);
170         GET_FUNC(SetDeviceClipping);
171         GET_FUNC(SetDeviceGammaRamp);
172         GET_FUNC(SetMapMode);
173         GET_FUNC(SetMapperFlags);
174         GET_FUNC(SetPixel);
175         GET_FUNC(SetPixelFormat);
176         GET_FUNC(SetPolyFillMode);
177         GET_FUNC(SetROP2);
178         GET_FUNC(SetRelAbs);
179         GET_FUNC(SetStretchBltMode);
180         GET_FUNC(SetTextAlign);
181         GET_FUNC(SetTextCharacterExtra);
182         GET_FUNC(SetTextColor);
183         GET_FUNC(SetTextJustification);
184         GET_FUNC(SetViewportExt);
185         GET_FUNC(SetViewportOrg);
186         GET_FUNC(SetWindowExt);
187         GET_FUNC(SetWindowOrg);
188         GET_FUNC(SetWorldTransform);
189         GET_FUNC(StartDoc);
190         GET_FUNC(StartPage);
191         GET_FUNC(StretchBlt);
192         GET_FUNC(StretchDIBits);
193         GET_FUNC(StrokeAndFillPath);
194         GET_FUNC(StrokePath);
195         GET_FUNC(SwapBuffers);
196         GET_FUNC(UnrealizePalette);
197         GET_FUNC(WidenPath);
198
199         /* OpenGL32 */
200         GET_FUNC(wglCreateContext);
201         GET_FUNC(wglDeleteContext);
202         GET_FUNC(wglGetProcAddress);
203         GET_FUNC(wglGetPbufferDCARB);
204         GET_FUNC(wglMakeContextCurrentARB);
205         GET_FUNC(wglMakeCurrent);
206         GET_FUNC(wglSetPixelFormatWINE);
207         GET_FUNC(wglShareLists);
208         GET_FUNC(wglUseFontBitmapsA);
209         GET_FUNC(wglUseFontBitmapsW);
210 #undef GET_FUNC
211     }
212     else memset( &driver->funcs, 0, sizeof(driver->funcs) );
213
214     /* add it to the list */
215     driver->prev = NULL;
216     if ((driver->next = first_driver)) driver->next->prev = driver;
217     first_driver = driver;
218     return driver;
219 }
220
221
222 /**********************************************************************
223  *           load_display_driver
224  *
225  * Special case for loading the display driver: get the name from the config file
226  */
227 static struct graphics_driver *load_display_driver(void)
228 {
229     char buffer[MAX_PATH], libname[32], *name, *next;
230     HMODULE module = 0;
231     HKEY hkey;
232
233     if (display_driver)  /* already loaded */
234     {
235         display_driver->count++;
236         return display_driver;
237     }
238
239     strcpy( buffer, "x11" );  /* default value */
240     /* @@ Wine registry key: HKCU\Software\Wine\Drivers */
241     if (!RegOpenKeyA( HKEY_CURRENT_USER, "Software\\Wine\\Drivers", &hkey ))
242     {
243         DWORD type, count = sizeof(buffer);
244         RegQueryValueExA( hkey, "Graphics", 0, &type, (LPBYTE) buffer, &count );
245         RegCloseKey( hkey );
246     }
247
248     name = buffer;
249     while (name)
250     {
251         next = strchr( name, ',' );
252         if (next) *next++ = 0;
253
254         snprintf( libname, sizeof(libname), "wine%s.drv", name );
255         if ((module = LoadLibraryA( libname )) != 0) break;
256         name = next;
257     }
258
259     if (!(display_driver = create_driver( module )))
260     {
261         MESSAGE( "Could not create graphics driver '%s'\n", buffer );
262         FreeLibrary( module );
263         ExitProcess(1);
264     }
265
266     display_driver->count++;  /* we don't want to free it */
267     return display_driver;
268 }
269
270
271 /**********************************************************************
272  *           DRIVER_load_driver
273  */
274 const DC_FUNCTIONS *DRIVER_load_driver( LPCWSTR name )
275 {
276     HMODULE module;
277     struct graphics_driver *driver;
278     static const WCHAR displayW[] = { 'd','i','s','p','l','a','y',0 };
279     static const WCHAR display1W[] = {'\\','\\','.','\\','D','I','S','P','L','A','Y','1',0};
280
281     EnterCriticalSection( &driver_section );
282
283     /* display driver is a special case */
284     if (!strcmpiW( name, displayW ) || 
285         !strcmpiW( name, display1W ))
286     {
287         driver = load_display_driver();
288         LeaveCriticalSection( &driver_section );
289         return &driver->funcs;
290     }
291
292     if ((module = GetModuleHandleW( name )))
293     {
294         for (driver = first_driver; driver; driver = driver->next)
295         {
296             if (driver->module == module)
297             {
298                 driver->count++;
299                 LeaveCriticalSection( &driver_section );
300                 return &driver->funcs;
301             }
302         }
303     }
304
305     if (!(module = LoadLibraryW( name )))
306     {
307         LeaveCriticalSection( &driver_section );
308         return NULL;
309     }
310
311     if (!(driver = create_driver( module )))
312     {
313         FreeLibrary( module );
314         LeaveCriticalSection( &driver_section );
315         return NULL;
316     }
317
318     TRACE( "loaded driver %p for %s\n", driver, debugstr_w(name) );
319     LeaveCriticalSection( &driver_section );
320     return &driver->funcs;
321 }
322
323
324 /**********************************************************************
325  *           DRIVER_get_driver
326  *
327  * Get a new copy of an existing driver.
328  */
329 const DC_FUNCTIONS *DRIVER_get_driver( const DC_FUNCTIONS *funcs )
330 {
331     struct graphics_driver *driver;
332
333     EnterCriticalSection( &driver_section );
334     for (driver = first_driver; driver; driver = driver->next)
335         if (&driver->funcs == funcs) break;
336     if (!driver) ERR( "driver not found, trouble ahead\n" );
337     driver->count++;
338     LeaveCriticalSection( &driver_section );
339     return funcs;
340 }
341
342
343 /**********************************************************************
344  *           DRIVER_release_driver
345  *
346  * Release a driver by decrementing ref count and freeing it if needed.
347  */
348 void DRIVER_release_driver( const DC_FUNCTIONS *funcs )
349 {
350     struct graphics_driver *driver;
351
352     EnterCriticalSection( &driver_section );
353
354     for (driver = first_driver; driver; driver = driver->next)
355         if (&driver->funcs == funcs) break;
356
357     if (!driver) goto done;
358     if (--driver->count) goto done;
359
360     /* removed last reference, free it */
361     if (driver->next) driver->next->prev = driver->prev;
362     if (driver->prev) driver->prev->next = driver->next;
363     else first_driver = driver->next;
364     if (driver == display_driver) display_driver = NULL;
365
366     FreeLibrary( driver->module );
367     HeapFree( GetProcessHeap(), 0, driver );
368  done:
369     LeaveCriticalSection( &driver_section );
370 }
371
372
373 /*****************************************************************************
374  *      DRIVER_GetDriverName
375  *
376  */
377 BOOL DRIVER_GetDriverName( LPCWSTR device, LPWSTR driver, DWORD size )
378 {
379     static const WCHAR displayW[] = { 'd','i','s','p','l','a','y',0 };
380     static const WCHAR devicesW[] = { 'd','e','v','i','c','e','s',0 };
381     static const WCHAR display1W[] = {'\\','\\','.','\\','D','I','S','P','L','A','Y','1',0};
382     static const WCHAR empty_strW[] = { 0 };
383     WCHAR *p;
384
385     /* display is a special case */
386     if (!strcmpiW( device, displayW ) ||
387         !strcmpiW( device, display1W ))
388     {
389         lstrcpynW( driver, displayW, size );
390         return TRUE;
391     }
392
393     size = GetProfileStringW(devicesW, device, empty_strW, driver, size);
394     if(!size) {
395         WARN("Unable to find %s in [devices] section of win.ini\n", debugstr_w(device));
396         return FALSE;
397     }
398     p = strchrW(driver, ',');
399     if(!p)
400     {
401         WARN("%s entry in [devices] section of win.ini is malformed.\n", debugstr_w(device));
402         return FALSE;
403     }
404     *p = 0;
405     TRACE("Found %s for %s\n", debugstr_w(driver), debugstr_w(device));
406     return TRUE;
407 }
408
409
410 /***********************************************************************
411  *           GdiConvertToDevmodeW    (GDI32.@)
412  */
413 DEVMODEW * WINAPI GdiConvertToDevmodeW(const DEVMODEA *dmA)
414 {
415     DEVMODEW *dmW;
416     WORD dmW_size, dmA_size;
417
418     dmA_size = dmA->dmSize;
419
420     /* this is the minimal dmSize that XP accepts */
421     if (dmA_size < FIELD_OFFSET(DEVMODEA, dmFields))
422         return NULL;
423
424     if (dmA_size > sizeof(DEVMODEA))
425         dmA_size = sizeof(DEVMODEA);
426
427     dmW_size = dmA_size + CCHDEVICENAME;
428     if (dmA_size >= FIELD_OFFSET(DEVMODEA, dmFormName) + CCHFORMNAME)
429         dmW_size += CCHFORMNAME;
430
431     dmW = HeapAlloc(GetProcessHeap(), 0, dmW_size + dmA->dmDriverExtra);
432     if (!dmW) return NULL;
433
434     MultiByteToWideChar(CP_ACP, 0, (const char*) dmA->dmDeviceName, -1,
435                                    dmW->dmDeviceName, CCHDEVICENAME);
436     /* copy slightly more, to avoid long computations */
437     memcpy(&dmW->dmSpecVersion, &dmA->dmSpecVersion, dmA_size - CCHDEVICENAME);
438
439     if (dmA_size >= FIELD_OFFSET(DEVMODEA, dmFormName) + CCHFORMNAME)
440     {
441         if (dmA->dmFields & DM_FORMNAME)
442             MultiByteToWideChar(CP_ACP, 0, (const char*) dmA->dmFormName, -1,
443                                        dmW->dmFormName, CCHFORMNAME);
444         else
445             dmW->dmFormName[0] = 0;
446
447         if (dmA_size > FIELD_OFFSET(DEVMODEA, dmLogPixels))
448             memcpy(&dmW->dmLogPixels, &dmA->dmLogPixels, dmA_size - FIELD_OFFSET(DEVMODEA, dmLogPixels));
449     }
450
451     if (dmA->dmDriverExtra)
452         memcpy((char *)dmW + dmW_size, (const char *)dmA + dmA_size, dmA->dmDriverExtra);
453
454     dmW->dmSize = dmW_size;
455
456     return dmW;
457 }
458
459
460 /*****************************************************************************
461  *      @ [GDI32.100]
462  *
463  * This should thunk to 16-bit and simply call the proc with the given args.
464  */
465 INT WINAPI GDI_CallDevInstall16( FARPROC16 lpfnDevInstallProc, HWND hWnd,
466                                  LPSTR lpModelName, LPSTR OldPort, LPSTR NewPort )
467 {
468     FIXME("(%p, %p, %s, %s, %s)\n", lpfnDevInstallProc, hWnd, lpModelName, OldPort, NewPort );
469     return -1;
470 }
471
472 /*****************************************************************************
473  *      @ [GDI32.101]
474  *
475  * This should load the correct driver for lpszDevice and calls this driver's
476  * ExtDeviceModePropSheet proc.
477  *
478  * Note: The driver calls a callback routine for each property sheet page; these
479  * pages are supposed to be filled into the structure pointed to by lpPropSheet.
480  * The layout of this structure is:
481  *
482  * struct
483  * {
484  *   DWORD  nPages;
485  *   DWORD  unknown;
486  *   HPROPSHEETPAGE  pages[10];
487  * };
488  */
489 INT WINAPI GDI_CallExtDeviceModePropSheet16( HWND hWnd, LPCSTR lpszDevice,
490                                              LPCSTR lpszPort, LPVOID lpPropSheet )
491 {
492     FIXME("(%p, %s, %s, %p)\n", hWnd, lpszDevice, lpszPort, lpPropSheet );
493     return -1;
494 }
495
496 /*****************************************************************************
497  *      @ [GDI32.102]
498  *
499  * This should load the correct driver for lpszDevice and calls this driver's
500  * ExtDeviceMode proc.
501  *
502  * FIXME: convert ExtDeviceMode to unicode in the driver interface
503  */
504 INT WINAPI GDI_CallExtDeviceMode16( HWND hwnd,
505                                     LPDEVMODEA lpdmOutput, LPSTR lpszDevice,
506                                     LPSTR lpszPort, LPDEVMODEA lpdmInput,
507                                     LPSTR lpszProfile, DWORD fwMode )
508 {
509     WCHAR deviceW[300];
510     WCHAR bufW[300];
511     char buf[300];
512     HDC hdc;
513     DC *dc;
514     INT ret = -1;
515
516     TRACE("(%p, %p, %s, %s, %p, %s, %d)\n",
517           hwnd, lpdmOutput, lpszDevice, lpszPort, lpdmInput, lpszProfile, fwMode );
518
519     if (!lpszDevice) return -1;
520     if (!MultiByteToWideChar(CP_ACP, 0, lpszDevice, -1, deviceW, 300)) return -1;
521
522     if(!DRIVER_GetDriverName( deviceW, bufW, 300 )) return -1;
523
524     if (!WideCharToMultiByte(CP_ACP, 0, bufW, -1, buf, 300, NULL, NULL)) return -1;
525
526     if (!(hdc = CreateICA( buf, lpszDevice, lpszPort, NULL ))) return -1;
527
528     if ((dc = get_dc_ptr( hdc )))
529     {
530         if (dc->funcs->pExtDeviceMode)
531             ret = dc->funcs->pExtDeviceMode( buf, hwnd, lpdmOutput, lpszDevice, lpszPort,
532                                              lpdmInput, lpszProfile, fwMode );
533         release_dc_ptr( dc );
534     }
535     DeleteDC( hdc );
536     return ret;
537 }
538
539 /****************************************************************************
540  *      @ [GDI32.103]
541  *
542  * This should load the correct driver for lpszDevice and calls this driver's
543  * AdvancedSetupDialog proc.
544  */
545 INT WINAPI GDI_CallAdvancedSetupDialog16( HWND hwnd, LPSTR lpszDevice,
546                                           LPDEVMODEA devin, LPDEVMODEA devout )
547 {
548     TRACE("(%p, %s, %p, %p)\n", hwnd, lpszDevice, devin, devout );
549     return -1;
550 }
551
552 /*****************************************************************************
553  *      @ [GDI32.104]
554  *
555  * This should load the correct driver for lpszDevice and calls this driver's
556  * DeviceCapabilities proc.
557  *
558  * FIXME: convert DeviceCapabilities to unicode in the driver interface
559  */
560 DWORD WINAPI GDI_CallDeviceCapabilities16( LPCSTR lpszDevice, LPCSTR lpszPort,
561                                            WORD fwCapability, LPSTR lpszOutput,
562                                            LPDEVMODEA lpdm )
563 {
564     WCHAR deviceW[300];
565     WCHAR bufW[300];
566     char buf[300];
567     HDC hdc;
568     DC *dc;
569     INT ret = -1;
570
571     TRACE("(%s, %s, %d, %p, %p)\n", lpszDevice, lpszPort, fwCapability, lpszOutput, lpdm );
572
573     if (!lpszDevice) return -1;
574     if (!MultiByteToWideChar(CP_ACP, 0, lpszDevice, -1, deviceW, 300)) return -1;
575
576     if(!DRIVER_GetDriverName( deviceW, bufW, 300 )) return -1;
577
578     if (!WideCharToMultiByte(CP_ACP, 0, bufW, -1, buf, 300, NULL, NULL)) return -1;
579
580     if (!(hdc = CreateICA( buf, lpszDevice, lpszPort, NULL ))) return -1;
581
582     if ((dc = get_dc_ptr( hdc )))
583     {
584         if (dc->funcs->pDeviceCapabilities)
585             ret = dc->funcs->pDeviceCapabilities( buf, lpszDevice, lpszPort,
586                                                   fwCapability, lpszOutput, lpdm );
587         release_dc_ptr( dc );
588     }
589     DeleteDC( hdc );
590     return ret;
591 }
592
593
594 /************************************************************************
595  *             Escape  [GDI32.@]
596  */
597 INT WINAPI Escape( HDC hdc, INT escape, INT in_count, LPCSTR in_data, LPVOID out_data )
598 {
599     INT ret;
600     POINT *pt;
601
602     switch (escape)
603     {
604     case ABORTDOC:
605         return AbortDoc( hdc );
606
607     case ENDDOC:
608         return EndDoc( hdc );
609
610     case GETPHYSPAGESIZE:
611         pt = out_data;
612         pt->x = GetDeviceCaps( hdc, PHYSICALWIDTH );
613         pt->y = GetDeviceCaps( hdc, PHYSICALHEIGHT );
614         return 1;
615
616     case GETPRINTINGOFFSET:
617         pt = out_data;
618         pt->x = GetDeviceCaps( hdc, PHYSICALOFFSETX );
619         pt->y = GetDeviceCaps( hdc, PHYSICALOFFSETY );
620         return 1;
621
622     case GETSCALINGFACTOR:
623         pt = out_data;
624         pt->x = GetDeviceCaps( hdc, SCALINGFACTORX );
625         pt->y = GetDeviceCaps( hdc, SCALINGFACTORY );
626         return 1;
627
628     case NEWFRAME:
629         return EndPage( hdc );
630
631     case SETABORTPROC:
632         return SetAbortProc( hdc, (ABORTPROC)in_data );
633
634     case STARTDOC:
635         {
636             DOCINFOA doc;
637             char *name = NULL;
638
639             /* in_data may not be 0 terminated so we must copy it */
640             if (in_data)
641             {
642                 name = HeapAlloc( GetProcessHeap(), 0, in_count+1 );
643                 memcpy( name, in_data, in_count );
644                 name[in_count] = 0;
645             }
646             /* out_data is actually a pointer to the DocInfo structure and used as
647              * a second input parameter */
648             if (out_data) doc = *(DOCINFOA *)out_data;
649             else
650             {
651                 doc.cbSize = sizeof(doc);
652                 doc.lpszOutput = NULL;
653                 doc.lpszDatatype = NULL;
654                 doc.fwType = 0;
655             }
656             doc.lpszDocName = name;
657             ret = StartDocA( hdc, &doc );
658             HeapFree( GetProcessHeap(), 0, name );
659             if (ret > 0) ret = StartPage( hdc );
660             return ret;
661         }
662
663     case QUERYESCSUPPORT:
664         {
665             const INT *ptr = (const INT *)in_data;
666             if (in_count < sizeof(INT)) return 0;
667             switch(*ptr)
668             {
669             case ABORTDOC:
670             case ENDDOC:
671             case GETPHYSPAGESIZE:
672             case GETPRINTINGOFFSET:
673             case GETSCALINGFACTOR:
674             case NEWFRAME:
675             case QUERYESCSUPPORT:
676             case SETABORTPROC:
677             case STARTDOC:
678                 return TRUE;
679             }
680             break;
681         }
682     }
683
684     /* if not handled internally, pass it to the driver */
685     return ExtEscape( hdc, escape, in_count, in_data, 0, out_data );
686 }
687
688
689 /******************************************************************************
690  *              ExtEscape       [GDI32.@]
691  *
692  * Access capabilities of a particular device that are not available through GDI.
693  *
694  * PARAMS
695  *    hdc         [I] Handle to device context
696  *    nEscape     [I] Escape function
697  *    cbInput     [I] Number of bytes in input structure
698  *    lpszInData  [I] Pointer to input structure
699  *    cbOutput    [I] Number of bytes in output structure
700  *    lpszOutData [O] Pointer to output structure
701  *
702  * RETURNS
703  *    Success: >0
704  *    Not implemented: 0
705  *    Failure: <0
706  */
707 INT WINAPI ExtEscape( HDC hdc, INT nEscape, INT cbInput, LPCSTR lpszInData,
708                       INT cbOutput, LPSTR lpszOutData )
709 {
710     INT ret = 0;
711     DC * dc = get_dc_ptr( hdc );
712     if (dc)
713     {
714         if (dc->funcs->pExtEscape)
715             ret = dc->funcs->pExtEscape( dc->physDev, nEscape, cbInput, lpszInData, cbOutput, lpszOutData );
716         release_dc_ptr( dc );
717     }
718     return ret;
719 }
720
721
722 /*******************************************************************
723  *      DrawEscape [GDI32.@]
724  *
725  *
726  */
727 INT WINAPI DrawEscape(HDC hdc, INT nEscape, INT cbInput, LPCSTR lpszInData)
728 {
729     FIXME("DrawEscape, stub\n");
730     return 0;
731 }