Author: cwittich Date: Sun Feb 10 23:45:56 2008 New Revision: 32279
URL: http://svn.reactos.org/svn/reactos?rev=32279&view=rev Log: translate some GreatLordish comments into something more similar to English
Modified: trunk/reactos/dll/directx/ddraw/cleanup.c trunk/reactos/dll/directx/ddraw/main.c
Modified: trunk/reactos/dll/directx/ddraw/cleanup.c URL: http://svn.reactos.org/svn/reactos/trunk/reactos/dll/directx/ddraw/cleanup.c... ============================================================================== --- trunk/reactos/dll/directx/ddraw/cleanup.c (original) +++ trunk/reactos/dll/directx/ddraw/cleanup.c Sun Feb 10 23:45:56 2008 @@ -35,7 +35,7 @@ DdDeleteDirectDrawObject(&ddgbl);
/* - are it any more I forget to release ? + anything else to release? */
/* release the linked interface */
Modified: trunk/reactos/dll/directx/ddraw/main.c URL: http://svn.reactos.org/svn/reactos/trunk/reactos/dll/directx/ddraw/main.c?re... ============================================================================== --- trunk/reactos/dll/directx/ddraw/main.c (original) +++ trunk/reactos/dll/directx/ddraw/main.c Sun Feb 10 23:45:56 2008 @@ -77,8 +77,8 @@ * <FILLMEIN>. * * @param pUnkOuter -* Alwas set to NULL other wise will DirectDrawCreate fail it return -* errror code CLASS_E_NOAGGREGATION +* Always set to NULL otherwise DirectDrawCreate will fail and return +* error code CLASS_E_NOAGGREGATION * * @return <FILLMEIN>. * @@ -94,14 +94,14 @@ { HRESULT retVal = DDERR_GENERIC; /* - remove this when UML digram are in place - this api is finish and is working as it should + remove this when UML diagram is in place + this api is finished and is working as it should */
DX_WINDBG_trace(); _SEH_TRY { - /* check see if pUnkOuter is null or not */ + /* check if pUnkOuter is null or not */ if (pUnkOuter) { retVal = CLASS_E_NOAGGREGATION; @@ -131,8 +131,8 @@ * <FILLMEIN>. * * @param pUnkOuter -* Alwas set to NULL other wise will DirectDrawCreateEx fail it return -* errror code CLASS_E_NOAGGREGATION +* Always set to NULL otherwise DirectDrawCreateEx will fail and return +* error code CLASS_E_NOAGGREGATION * * @return <FILLMEIN>. * @@ -148,8 +148,8 @@ { HRESULT retVal = DDERR_GENERIC; /* - remove this when UML digram are in place - this api is finish and is working as it should + remove this when UML diagram is in place + this api is finished and is working as it should */ DX_WINDBG_trace();
@@ -249,17 +249,17 @@ RegCloseKey(hKey); }
- /* Call the user supplyed callback function */ + /* Call the user supplied callback function */ rc = lpCallback(NULL, strMsg, "display", lpContext, NULL);
- /* If the callback function returns DDENUMRET_CANCEL, we will stop enumerating devices now */ + /* If the callback function returns DDENUMRET_CANCEL, we will stop enumerating devices */ if(rc == DDENUMRET_CANCEL) { retVal = DD_OK; } else { - // not finish + // not finished retVal = DDERR_UNSUPPORTED; } } @@ -295,11 +295,10 @@ See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/ Display_d/hh/Display_d/d3d_21ac30ea-9803-401e-b541-6b08af79653d.xml.asp
- for more info about this command - - summuer the msdn - - The buffer start with D3DHAL_DP2COMMAND struct afer that it follow either one struct or no struct at at all + for more info about this command see msdn documentation + + The buffer start with D3DHAL_DP2COMMAND struct afer that follows either one struct or + no struct at at all example for command D3DDP2OP_VIEWPORTINFO
then lpCmd will look like this @@ -311,9 +310,9 @@ | D3DHAL_DP2VIEWPORTINFO | 0x04 - xxxx | ---------------------------------------
- to calc end of the lpCmd buffer in this exmaple + to calculate the end of the lpCmd buffer in this exmaple D3DHAL_DP2COMMAND->wStateCount * sizeof(D3DHAL_DP2VIEWPORTINFO); - now you got number of bytes but we need add the size of D3DHAL_DP2COMMAND + now you got number of bytes but we need to add the size of D3DHAL_DP2COMMAND to get this right. the end should be sizeof(D3DHAL_DP2COMMAND) + ( D3DHAL_DP2COMMAND->wStateCount * sizeof(D3DHAL_DP2VIEWPORTINFO)); to get the xxxx end positions. @@ -338,12 +337,12 @@ * } D3DHAL_DP2COMMAND, *LPD3DHAL_DP2COMMAND; * * lpCmd->bCommand -* only accpect D3DDP2OP_VIEWPORTINFO, and undocument command 0x0D -* rest of the command will be return error code for. +* only accept D3DDP2OP_VIEWPORTINFO, and undocumented command 0x0D +* anything else will result in an error * Command 0x0D * dp2command->bReserved -* is how big struect we got in wStateCount or how many wStateCount we got +* is the size of the struct we got in wStateCount or how many wStateCount we got * do not known more about it, no info in msdn about it either. * * Command D3DDP2OP_VIEWPORTINFO @@ -378,7 +377,7 @@
switch (dp2command->bCommand) { - /* check for vaild command, only 3 command is vaild */ + /* check for vaild command, only 3 commands are vaild */ case D3DDP2OP_VIEWPORTINFO: *(PBYTE)lpRetCmd += ((dp2command->wStateCount * sizeof(D3DHAL_DP2VIEWPORTINFO)) + sizeof(D3DHAL_DP2COMMAND)); break;