[greatlrd] 32696: update the docs for NtGdiD3dContextCreate some points I did not make clear how it works.

Author: greatlrd
Date: Sat Mar 15 19:16:42 2008
New Revision: 32696

URL: http://svn.reactos.org/svn/reactos?rev=3D32696&view=3Drev
Log:
update the docs for NtGdiD3dContextCreate
some points I did not make clear how it works. =

Modified:
    trunk/reactos/subsystems/win32/win32k/ntddraw/d3d.c

Modified: trunk/reactos/subsystems/win32/win32k/ntddraw/d3d.c
URL: http://svn.reactos.org/svn/reactos/trunk/reactos/subsystems/win32/win3=
2k/ntddraw/d3d.c?rev=3D32696&r1=3D32695&r2=3D32696&view=3Ddiff
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
--- trunk/reactos/subsystems/win32/win32k/ntddraw/d3d.c (original)
+++ trunk/reactos/subsystems/win32/win32k/ntddraw/d3d.c Sat Mar 15 19:16:42=
 2008
@@ -89,29 +89,35 @@
 * @param HANDLE hSurfZ
 * Handle to a DD_SURFACE_LOCAL. It is the Z deep buffer. According MSDN if=
 it is set to NULL nothing should happen.
 *
-* @param D3DNTHAL_CONTEXTCREATEDATA* hSurfZ
+* @param LPD3DNTHAL_CONTEXTCREATEDATA pdcci
 * The buffer to create the context data
 *
 * @return =

* DDHAL_DRIVER_HANDLED or DDHAL_DRIVER_NOTHANDLED if the driver supports t=
his function.
 * A full check is done by checking if the return value is DDHAL_DRIVER_HAN=
DLED =

-* and puCanCreateSurfaceData->ddRVal is set to DD_OK.
+* and pdcci->ddRVal is set to DD_OK.
 *
 *
 * @remarks.
 * dxg.sys NtGdiD3dContextCreate calls are redirected to the same function =
in the dxg.sys. As such they all work the same way.
 *
-* Before calling this function please set the hSurfZ->ddRVal to an error v=
alue such as DDERR_NOTUSPORTED,
+* Before calling this function please set the pdcci->ddRVal to an error va=
lue such as DDERR_NOTSUPORTED,
 * for the ddRVal will otherwise be unchanged even if an error occurs insid=
e the driver. =

-* hSurfZ->dwhContext also needs to be filled in with the handle we got fro=
m NtGdiDdCreateDirectDrawObject
-*
+*
+* pdcci->lpDDLcl is a pointer to DDRAWI_DIRECTDRAW_LCL, not DD_DIRECTDRAW_=
LOCAL  as MSDN claims.
+* pdcci->lpDDSLcl is a pointer to DDRAWI_DDRAWSURFACE_LCL, not DD_DDDRAWSU=
RFACE_LOCAL as MSDN claims.
+* pdcci->lpDDSZLcl is a pointer to DDRAWI_DDRAWSURFACE_LCL, not DD_DDRAWSU=
RFACE_LOCAL as MSDN claims.
+* pdcci->dwhContext also needs be filled in with the handle we receive fro=
m NtGdiDdCreateDirectDrawObject.
+* pdcci->dwPID the processid it belong to, that you need to fill in.
+* Do not forget LPD3DNTHAL_CONTEXTCREATEDATA is typecast of LPD3DHAL_CONTE=
XTCREATEDATA and thuse two struct are different size,
+* the correct struct is LPD3DHAL_CONTEXTCREATEDATA.
 *--*/
 BOOL =

STDCALL
 NtGdiD3dContextCreate(HANDLE hDirectDrawLocal,
                       HANDLE hSurfColor,
                       HANDLE hSurfZ,
-                      D3DNTHAL_CONTEXTCREATEDATA* pdcci)
+                      LPD3DNTHAL_CONTEXTCREATEDATA pdcci)
 {
     PGD_D3DCONTEXTCREATE pfnD3dContextCreate =3D (PGD_D3DCONTEXTCREATE)gpD=
xFuncs[DXG_INDEX_DxD3dContextCreate].pfn;
 =