reactos/w32api/include/ddk/ddkmapi.h

   1 /*
   2  * ddkmapi.h
   3  *
   4  * DirectDraw support for DxApi function
   5  *
   6  * This file is part of the w32api package.
   7  *
   8  * Contributors:
   9  *   Created by Casper S. Hornstrup <chorns@users.sourceforge.net>
  10  *
  11  * THIS SOFTWARE IS NOT COPYRIGHTED
  12  *
  13  * This source code is offered for use in the public domain. You may
  14  * use, modify or distribute it freely.
  15  *
  16  * This code is distributed in the hope that it will be useful but
  17  * WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY
  18  * DISCLAIMED. This includes but is not limited to warranties of
  19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  20  *
  21  */
  22
  23 #ifndef __DDKMAPI_H
  24 #define __DDKMAPI_H
  25
  26 #if __GNUC__ >=3
  27 #pragma GCC system_header
  28 #endif
  29
  30 #ifdef __cplusplus
  31 extern "C" {
  32 #endif
  33
  34 #include "ntddk.h"
  35
  36 #if defined(_DXAPI_)
  37   #define DXAPI DECLSPEC_EXPORT
  38 #else
  39   #define DXAPI DECLSPEC_IMPORT
  40 #endif
  41
  42 DXAPI
  43 DWORD
  44 FAR PASCAL
  45 DxApi(
  46   IN DWORD  dwFunctionNum,
  47   IN LPVOID  lpvInBuffer,
  48   IN DWORD  cbInBuffer,
  49   OUT LPVOID  lpvOutBuffer,
  50   OUT DWORD  cbOutBuffer);
  51
  52 typedef DWORD (FAR PASCAL *LPDXAPI)(
  53   DWORD  dwFunctionNum,
  54   LPVOID  lpvInBuffer,
  55   DWORD  cbInBuffer,
  56   LPVOID  lpvOutBuffer,
  57   DWORD  cbOutBuffer);
  58
  59
  60 #define DXAPI_MAJORVERSION                1
  61 #define DXAPI_MINORVERSION                0
  62
  63 #define DD_FIRST_DXAPI                    0x500
  64
  65 #define DD_DXAPI_GETVERSIONNUMBER                 (DD_FIRST_DXAPI)
  66 #define DD_DXAPI_CLOSEHANDLE                      (DD_FIRST_DXAPI+1)
  67 #define DD_DXAPI_OPENDIRECTDRAW                   (DD_FIRST_DXAPI+2)
  68 #define DD_DXAPI_OPENSURFACE                      (DD_FIRST_DXAPI+3)
  69 #define DD_DXAPI_OPENVIDEOPORT                    (DD_FIRST_DXAPI+4)
  70 #define DD_DXAPI_GETKERNELCAPS                    (DD_FIRST_DXAPI+5)
  71 #define DD_DXAPI_GET_VP_FIELD_NUMBER              (DD_FIRST_DXAPI+6)
  72 #define DD_DXAPI_SET_VP_FIELD_NUMBER              (DD_FIRST_DXAPI+7)
  73 #define DD_DXAPI_SET_VP_SKIP_FIELD                (DD_FIRST_DXAPI+8)
  74 #define DD_DXAPI_GET_SURFACE_STATE                (DD_FIRST_DXAPI+9)
  75 #define DD_DXAPI_SET_SURFACE_STATE                (DD_FIRST_DXAPI+10)
  76 #define DD_DXAPI_LOCK                             (DD_FIRST_DXAPI+11)
  77 #define DD_DXAPI_FLIP_OVERLAY                     (DD_FIRST_DXAPI+12)
  78 #define DD_DXAPI_FLIP_VP                          (DD_FIRST_DXAPI+13)
  79 #define DD_DXAPI_GET_CURRENT_VP_AUTOFLIP_SURFACE  (DD_FIRST_DXAPI+14)
  80 #define DD_DXAPI_GET_LAST_VP_AUTOFLIP_SURFACE     (DD_FIRST_DXAPI+15)
  81 #define DD_DXAPI_REGISTER_CALLBACK                (DD_FIRST_DXAPI+16)
  82 #define DD_DXAPI_UNREGISTER_CALLBACK              (DD_FIRST_DXAPI+17)
  83 #define DD_DXAPI_GET_POLARITY                     (DD_FIRST_DXAPI+18)
  84 #define DD_DXAPI_OPENVPCAPTUREDEVICE              (DD_FIRST_DXAPI+19)
  85 #define DD_DXAPI_ADDVPCAPTUREBUFFER               (DD_FIRST_DXAPI+20)
  86 #define DD_DXAPI_FLUSHVPCAPTUREBUFFERS            (DD_FIRST_DXAPI+21)
  87
  88
  89 typedef struct _DDCAPBUFFINFO {
  90   DWORD  dwFieldNumber;
  91   DWORD  bPolarity;
  92   LARGE_INTEGER  liTimeStamp;
  93   DWORD  ddRVal;
  94 } DDCAPBUFFINFO, FAR * LPDDCAPBUFFINFO;
  95
  96 /* DDADDVPCAPTUREBUFF.dwFlags constants */
  97 #define DDADDBUFF_SYSTEMMEMORY            0x0001
  98 #define DDADDBUFF_NONLOCALVIDMEM          0x0002
  99 #define DDADDBUFF_INVERT                  0x0004
 100
 101 typedef struct _DDADDVPCAPTUREBUFF {
 102   HANDLE  hCapture;
 103   DWORD  dwFlags;
 104   PMDL  pMDL;
 105   PKEVENT  pKEvent;
 106   LPDDCAPBUFFINFO  lpBuffInfo;
 107 } DDADDVPCAPTUREBUFF, FAR * LPDDADDVPCAPTUREBUFF;
 108
 109 typedef struct _DDCLOSEHANDLE {
 110   HANDLE  hHandle;
 111 } DDCLOSEHANDLE, FAR *LPDDCLOSEHANDLE;
 112
 113 typedef struct _DDFLIPOVERLAY {
 114   HANDLE  hDirectDraw;
 115   HANDLE  hCurrentSurface;
 116   HANDLE  hTargetSurface;
 117   DWORD  dwFlags;
 118 } DDFLIPOVERLAY, FAR *LPDDFLIPOVERLAY;
 119
 120 typedef struct _DDFLIPVIDEOPORT {
 121   HANDLE  hDirectDraw;
 122   HANDLE  hVideoPort;
 123   HANDLE  hCurrentSurface;
 124   HANDLE  hTargetSurface;
 125   DWORD  dwFlags;
 126 } DDFLIPVIDEOPORT, FAR *LPDDFLIPVIDEOPORT;
 127
 128 typedef struct _DDGETAUTOFLIPIN {
 129   HANDLE  hDirectDraw;
 130   HANDLE  hVideoPort;
 131 } DDGETAUTOFLIPIN, FAR *LPDDGETAUTOFLIPIN;
 132
 133 typedef struct _DDGETAUTOFLIPOUT {
 134   DWORD  ddRVal;
 135   HANDLE  hVideoSurface;
 136   HANDLE  hVBISurface;
 137   BOOL  bPolarity;
 138 } DDGETAUTOFLIPOUT, FAR *LPDDGETAUTOFLIPOUT;
 139
 140 typedef struct _DDGETPOLARITYIN {
 141   HANDLE  hDirectDraw;
 142   HANDLE  hVideoPort;
 143 } DDGETPOLARITYIN, FAR *LPDDGETPOLARITYIN;
 144
 145 typedef struct _DDGETPOLARITYOUT {
 146   DWORD  ddRVal;
 147   BOOL  bPolarity;
 148 } DDGETPOLARITYOUT, FAR *LPDDGETPOLARITYOUT;
 149
 150 typedef struct _DDGETSURFACESTATEIN {
 151   HANDLE  hDirectDraw;
 152   HANDLE  hSurface;
 153 } DDGETSURFACESTATEIN, FAR *LPDDGETSURFACESTATEIN;
 154
 155 /* DDGETSURFACESTATEOUT.dwStateCaps/dwStateStatus constants */
 156 #define DDSTATE_BOB                       0x0001
 157 #define DDSTATE_WEAVE                     0x0002
 158 #define DDSTATE_EXPLICITLY_SET            0x0004
 159 #define DDSTATE_SOFTWARE_AUTOFLIP         0x0008
 160 #define DDSTATE_SKIPEVENFIELDS            0x0010
 161
 162 typedef struct _DDGETSURFACESTATEOUT {
 163   DWORD  ddRVal;
 164   DWORD  dwStateCaps;
 165   DWORD  dwStateStatus;
 166 } DDGETSURFACESTATEOUT, FAR *LPDDGETSURFACESTATEOUT;
 167
 168 typedef struct _DDGETFIELDNUMIN {
 169   HANDLE  hDirectDraw;
 170   HANDLE  hVideoPort;
 171 } DDGETFIELDNUMIN, FAR *LPDDGETFIELDNUMIN;
 172
 173 typedef struct _DDGETFIELDNUMOUT {
 174   DWORD  ddRVal;
 175   DWORD  dwFieldNum;
 176 } DDGETFIELDNUMOUT, FAR *LPDDGETFIELDNUMOUT;
 177
 178 typedef struct _DDGETKERNELCAPSOUT {
 179   DWORD  ddRVal;
 180   DWORD  dwCaps;
 181   DWORD  dwIRQCaps;
 182 } DDGETKERNELCAPSOUT, FAR *LPDDGETKERNELCAPSOUT;
 183
 184 typedef struct _DDGETVERSIONNUMBER {
 185   DWORD  ddRVal;
 186   DWORD  dwMajorVersion;
 187   DWORD  dwMinorVersion;
 188 } DDGETVERSIONNUMBER, FAR *LPDDGETVERSIONNUMBER;
 189
 190 typedef struct _DDLOCKIN {
 191   HANDLE  hDirectDraw;
 192   HANDLE  hSurface;
 193 } DDLOCKIN, FAR *LPDDLOCKIN;
 194
 195 typedef struct _DDLOCKOUT {
 196   DWORD  ddRVal;
 197   DWORD  dwSurfHeight;
 198   DWORD  dwSurfWidth;
 199   LONG  lSurfPitch;
 200   PVOID  lpSurface;
 201   DWORD  SurfaceCaps;
 202   DWORD  dwFormatFlags;
 203   DWORD  dwFormatFourCC;
 204   DWORD  dwFormatBitCount;
 205   _ANONYMOUS_UNION union {
 206     DWORD  dwRBitMask;
 207     DWORD  dwYBitMask;
 208   } DUMMYUNIONNAME;
 209   _ANONYMOUS_UNION union {
 210     DWORD  dwGBitMask;
 211     DWORD  dwUBitMask;
 212   } DUMMYUNIONNAME2;
 213   _ANONYMOUS_UNION union {
 214     DWORD  dwBBitMask;
 215     DWORD  dwVBitMask;
 216   } DUMMYUNIONNAME3;
 217 } DDLOCKOUT, FAR *LPDDLOCKOUT;
 218
 219 /* LPDD_NOTIFYCALLBACK.dwFlags constants */
 220 #define DDNOTIFY_DISPLAY_VSYNC            0x0001
 221 #define DDNOTIFY_VP_VSYNC                 0x0002
 222 #define DDNOTIFY_VP_LINE                  0x0004
 223 #define DDNOTIFY_PRERESCHANGE             0x0008
 224 #define DDNOTIFY_POSTRESCHANGE            0x0010
 225 #define DDNOTIFY_PREDOSBOX                0x0020
 226 #define DDNOTIFY_POSTDOSBOX               0x0040
 227 #define DDNOTIFY_CLOSEDIRECTDRAW          0x0080
 228 #define DDNOTIFY_CLOSESURFACE             0x0100
 229 #define DDNOTIFY_CLOSEVIDEOPORT           0x0200
 230 #define DDNOTIFY_CLOSECAPTURE             0x0400
 231
 232 typedef ULONG (FAR PASCAL *LPDD_NOTIFYCALLBACK)(
 233   DWORD dwFlags,
 234   PVOID pContext,
 235   DWORD dwParam1,
 236   DWORD dwParam2);
 237
 238 typedef struct _DDOPENDIRECTDRAWIN {
 239   ULONG_PTR  dwDirectDrawHandle;
 240   LPDD_NOTIFYCALLBACK  pfnDirectDrawClose;
 241   PVOID  pContext;
 242 } DDOPENDIRECTDRAWIN, FAR *LPDDOPENDIRECTDRAWIN;
 243
 244 typedef struct _DDOPENDIRECTDRAWOUT {
 245   DWORD  ddRVal;
 246   HANDLE  hDirectDraw;
 247 } DDOPENDIRECTDRAWOUT, FAR *LPDDOPENDIRECTDRAWOUT;
 248
 249 typedef struct _DDOPENSURFACEIN {
 250   HANDLE  hDirectDraw;
 251   ULONG_PTR  dwSurfaceHandle;
 252   LPDD_NOTIFYCALLBACK  pfnSurfaceClose;
 253   PVOID  pContext;
 254 } DDOPENSURFACEIN, FAR *LPDDOPENSURFACEIN;
 255
 256 typedef struct _DDOPENSURFACEOUT {
 257   DWORD  ddRVal;
 258   HANDLE  hSurface;
 259 } DDOPENSURFACEOUT, FAR *LPDDOPENSURFACEOUT;
 260
 261 typedef struct _DDOPENVIDEOPORTIN {
 262   HANDLE  hDirectDraw;
 263   ULONG  dwVideoPortHandle;
 264   LPDD_NOTIFYCALLBACK  pfnVideoPortClose;
 265   PVOID  pContext;
 266 } DDOPENVIDEOPORTIN, FAR *LPDDOPENVIDEOPORTIN;
 267
 268 typedef struct _DDOPENVIDEOPORTOUT {
 269   DWORD  ddRVal;
 270   HANDLE  hVideoPort;
 271 } DDOPENVIDEOPORTOUT, FAR *LPDDOPENVIDEOPORTOUT;
 272
 273 /* DDOPENVPCAPTUREDEVICEIN.dwFlags constants */
 274 #define DDOPENCAPTURE_VIDEO               0x0001
 275 #define DDOPENCAPTURE_VBI                 0x0002
 276
 277 typedef struct _DDOPENVPCAPTUREDEVICEIN {
 278   HANDLE  hDirectDraw;
 279   HANDLE  hVideoPort;
 280   DWORD  dwStartLine;
 281   DWORD  dwEndLine;
 282   DWORD  dwCaptureEveryNFields;
 283   LPDD_NOTIFYCALLBACK  pfnCaptureClose;
 284   PVOID  pContext;
 285   DWORD  dwFlags;
 286 } DDOPENVPCAPTUREDEVICEIN, FAR * LPDDOPENVPCAPTUREDEVICEIN;
 287
 288 typedef struct _DDOPENVPCAPTUREDEVICEOUT {
 289   DWORD  ddRVal;
 290   HANDLE  hCapture;
 291 } DDOPENVPCAPTUREDEVICEOUT, FAR * LPDDOPENVPCAPTUREDEVICEOUT;
 292
 293 /* DDREGISTERCALLBACK.dwEvents constants */
 294 #define DDEVENT_DISPLAY_VSYNC             0x0001
 295 #define DDEVENT_VP_VSYNC                  0x0002
 296 #define DDEVENT_VP_LINE                   0x0004
 297 #define DDEVENT_PRERESCHANGE              0x0008
 298 #define DDEVENT_POSTRESCHANGE             0x0010
 299 #define DDEVENT_PREDOSBOX                 0x0020
 300 #define DDEVENT_POSTDOSBOX                0x0040
 301
 302 typedef struct _DDREGISTERCALLBACK {
 303   HANDLE  hDirectDraw;
 304   ULONG  dwEvents;
 305   LPDD_NOTIFYCALLBACK  pfnCallback;
 306   ULONG_PTR  dwParam1;
 307   ULONG_PTR  dwParam2;
 308   PVOID  pContext;
 309 } DDREGISTERCALLBACK, FAR *LPDDREGISTERCALLBACK;
 310
 311 typedef struct _DDSETSURFACETATE {
 312   HANDLE  hDirectDraw;
 313   HANDLE  hSurface;
 314   DWORD  dwState;
 315   DWORD  dwStartField;
 316 } DDSETSURFACESTATE, FAR *LPDDSETSURFACESTATE;
 317
 318 typedef struct _DDSETFIELDNUM {
 319   HANDLE  hDirectDraw;
 320   HANDLE  hVideoPort;
 321   DWORD  dwFieldNum;
 322 } DDSETFIELDNUM, FAR *LPDDSETFIELDNUM;
 323
 324 typedef struct _DDSETSKIPFIELD {
 325   HANDLE  hDirectDraw;
 326   HANDLE  hVideoPort;
 327   DWORD  dwStartField;
 328 } DDSETSKIPFIELD, FAR *LPDDSETSKIPFIELD;
 329
 330 #ifdef __cplusplus
 331 }
 332 #endif
 333
 334 #endif /* __DDKMAPI_H */