[ros-diffs] [greatlrd] 31581: cleanu dxeng.c add docs for DxEngGetHdevData

Author: greatlrd
Date: Thu Jan  3 18:33:54 2008
New Revision: 31581

URL: http://svn.reactos.org/svn/reactos?rev=31581&view=rev
Log:
cleanu dxeng.c
add docs for DxEngGetHdevData

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

Modified: trunk/reactos/subsystems/win32/win32k/ntddraw/dxeng.c
URL:
http://svn.reactos.org/svn/reactos/trunk/reactos/subsystems/win32/win32k/nt…
==============================================================================
--- trunk/reactos/subsystems/win32/win32k/ntddraw/dxeng.c (original)
+++ trunk/reactos/subsystems/win32/win32k/ntddraw/dxeng.c Thu Jan  3 18:33:54 2008
@@ -10,9 +10,8 @@
 
 #include <w32k.h>
 #include <debug.h>
+
 ERESOURCE  ghsemShareDevLock;
-
-
 
 ULONG gcEngFuncs = DXENG_INDEX_DxEngLoadImage + 1;
 DRVFN gaEngFuncs [] =
@@ -62,32 +61,6 @@
     {DXENG_INDEX_DxEngLoadImage, (PFN)DxEngLoadImage}
 };
 
-/************************************************************************/
-/* DxEngNUIsTermSrv                                                     */
-/************************************************************************/
-
-/* Notes : Check see if termal server got a connections or not */
-BOOL
-DxEngNUIsTermSrv()
-{
-    /* FIXME ReactOS does not suport terminal server yet, we can not check if we got a
connections or not */
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngRedrawDesktop                                                   */
-/************************************************************************/
-
-/* Notes : it always return TRUE, and it update whole the screen (redaw current desktop)
*/
-BOOL
-DxEngRedrawDesktop()
-{
-    /* FIXME add redraw code */
-    UNIMPLEMENTED;
-    return TRUE;
-}
-
 
 /*++
 * @name DxEngDispUniq
@@ -108,35 +81,11 @@
     return GdiHandleTable->flDeviceUniq;
 }
 
-ULONG gulVisRgnUniqueness; // Increase count everytime client region is updated.
-
-/************************************************************************/
-/* DxEngVisRgnUniq                                                      */
-/************************************************************************/
-/* Notes :  return the VisRgnUniq counter for win32k */
-ULONG
-DxEngVisRgnUniq()
-{
-    return gulVisRgnUniqueness;
-}
-
-/************************************************************************/
-/* DxEngEnumerateHdev                                                   */
-/************************************************************************/
-/* Enumerate all drivers in win32k */
-HDEV *
-DxEngEnumerateHdev(HDEV *hdev)
-{
-    /* FIXME Enumerate all drivers in win32k */
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
 /*++
 * @name DxEngGetDeviceGammaRamp
 * @implemented
 *
-* The function DxEngGetDeviceGammaRamp gets the gamma ramp in dxg.sys.
+* The function DxEngGetDeviceGammaRamp gets the gamma ramp to dxg.sys.
 
 * @param HDEV hPDev
 * The hdev.
@@ -202,25 +151,6 @@
 {
     DC_UnlockDc(pDC);
     return TRUE;
-}
-
-
-/************************************************************************/
-/* DxEngCreateMemoryDC                                                  */
-/************************************************************************/
-DWORD DxEngCreateMemoryDC(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngScreenAccessCheck                                               */
-/************************************************************************/
-DWORD DxEngScreenAccessCheck()
-{
-    UNIMPLEMENTED;
-    return FALSE;
 }
 
 /*++
@@ -276,53 +206,6 @@
     return TRUE;
 }
 
-/************************************************************************/
-/* DxEngLockHdev                                                        */
-/************************************************************************/
-DWORD DxEngLockHdev(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngUnlockHdev                                                      */
-/************************************************************************/
-DWORD DxEngUnlockHdev(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngReferenceHdev                                                   */
-/************************************************************************/
-DWORD DxEngReferenceHdev(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngIsHdevLockedByCurrentThread                                     */
-/************************************************************************/
-DWORD DxEngIsHdevLockedByCurrentThread(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-
-/************************************************************************/
-/* DxEngUnreferenceHdev                                                 */
-/************************************************************************/
-DWORD DxEngUnreferenceHdev(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-
 /*++
 * @name DxEngSetDeviceGammaRamp
 * @implemented
@@ -351,36 +234,45 @@
    return IntSetDeviceGammaRamp(hPDev, Ramp, Test);
 }
 
-/************************************************************************/
-/* DxEngSpTearDownSprites                                               */
-/************************************************************************/
-DWORD DxEngSpTearDownSprites(DWORD x1, DWORD x2, DWORD x3)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSpUnTearDownSprites                                             */
-/************************************************************************/
-DWORD DxEngSpUnTearDownSprites(DWORD x1, DWORD x2, DWORD x3)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSpSpritesVisible                                                */
-/************************************************************************/
-DWORD DxEngSpSpritesVisible(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngGetHdevData                                                     */
-/************************************************************************/
+/*++
+* @name DxEngGetHdevData
+* @implemented
+*
+* The function DxEngGetHdevData get a value in hdev
+
+* @param HDEV hPDev
+* The hdev
+*
+* @param DXEGSHDEVDATA Type
+* follow type are supported
+* type                      what it does
+* DxEGShDevData_Surface     get pointer to Surface handle.
+* DxEGShDevData_hSpooler    get If the device is a spooler driver.
+* DxEGShDevData_DitherFmt   get the device iDitherFormat
+* DxEGShDevData_FxCaps      get the device flGraphicsCaps
+* DxEGShDevData_FxCaps2     get the device flGraphicsCaps2
+* DxEGShDevData_DrvFuncs    get the device DriverFunctions function table
+* DxEGShDevData_dhpdev      get the device hPDev the real DHPDEV
+* DxEGShDevData_eddg        get the device pEDDgpl
+* DxEGShDevData_dd_nCount   get the device DxDd_nCount
+* DxEGShDevData_dd_flags    get the device DxDd_Flags
+* DxEGShDevData_disable     get if the device pdev is disable or not
+* DxEGShDevData_metadev     get if the device pdev is meta device or not
+* DxEGShDevData_display     get if the device is primary display driver or not
+* DxEGShDevData_Parent      get the ppdevParent
+* DxEGShDevData_OpenRefs    get the pdevOpenRefs counter
+* DxEGShDevData_palette     get the device RC_PALETTE is set or not
+* DxEGShDevData_ldev        ATM we do not support the Loader Device driver structure
+* DxEGShDevData_GDev        get the device pGraphicsDev
+* DxEGShDevData_clonedev    get the device PDEV_CLONE_DEVICE flag is set or not
+*
+* @return
+* Returns the data we requested
+*
+* @remarks.
+* ReactOS specific: Implementation ins incomplete, I do not save the value into the hdev
yet.
+*
+*--*/
 DWORD
 DxEngGetHdevData(HDEV hDev,
                  DXEGSHDEVDATA Type)
@@ -448,11 +340,11 @@
       case DxEGShDevData_clonedev:
         retVal = (DWORD) PDev->flFlags & PDEV_CLONE_DEVICE;
         break;
-        
+
       default:
-        break;            
+        break;
     }
-  
+
   return retVal;
 
 }
@@ -476,7 +368,7 @@
 * Returns TRUE for success, FALSE for failure
 *
 * @remarks.
-* ReactOS specific: Implementation ins incomplete, I do not save the value into the hdev
yet.
+* none
 *
 *--*/
 BOOLEAN
@@ -493,53 +385,6 @@
   }
   return retVal;
 }
-
-/************************************************************************/
-/* DxEngGetDesktopDC                                                    */
-/************************************************************************/
-DWORD DxEngGetDesktopDC(DWORD x1, DWORD x2, DWORD x3)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngDeleteDC                                                        */
-/************************************************************************/
-DWORD DxEngDeleteDC(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngCleanDC                                                         */
-/************************************************************************/
-BOOLEAN DxEngCleanDC(HDC hdc)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSetDCOwner                                                      */
-/************************************************************************/
-DWORD DxEngSetDCOwner(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSetDCState                                                      */
-/************************************************************************/
-DWORD DxEngSetDCState(DWORD x1, DWORD x2, DWORD x3)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-
 
 /*++
 * @name DxEngGetDCState
@@ -600,114 +445,6 @@
     return retVal;
 }
 
-/************************************************************************/
-/* DxEngSelectBitmap                                                    */
-/************************************************************************/
-DWORD DxEngSelectBitmap(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSetBitmapOwner                                                  */
-/************************************************************************/
-DWORD DxEngSetBitmapOwner(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngDeleteSurface                                                   */
-/************************************************************************/
-DWORD DxEngDeleteSurface(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngGetSurfaceData                                                  */
-/************************************************************************/
-DWORD DxEngGetSurfaceData(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngAltLockSurface                                                  */
-/************************************************************************/
-DWORD DxEngAltLockSurface(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngUploadPaletteEntryToSurface                                     */
-/************************************************************************/
-DWORD DxEngUploadPaletteEntryToSurface(DWORD x1, DWORD x2,DWORD x3, DWORD x4)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngMarkSurfaceAsDirectDraw                                         */
-/************************************************************************/
-DWORD DxEngMarkSurfaceAsDirectDraw(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSelectPaletteToSurface                                          */
-/************************************************************************/
-DWORD DxEngSelectPaletteToSurface(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSyncPaletteTableWithDevice                                      */
-/************************************************************************/
-DWORD DxEngSyncPaletteTableWithDevice(DWORD x1, DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngSetPaletteState                                                 */
-/************************************************************************/
-DWORD DxEngSetPaletteState(DWORD x1, DWORD x2, DWORD x3)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngGetRedirectionBitmap                                            */
-/************************************************************************/
-DWORD DxEngGetRedirectionBitmap(DWORD x1)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
-/************************************************************************/
-/* DxEngLoadImage                                                       */
-/************************************************************************/
-DWORD DxEngLoadImage(DWORD x1,DWORD x2)
-{
-    UNIMPLEMENTED;
-    return FALSE;
-}
-
 /*++
 * @name DxEngIncDispUniq
 * @implemented
@@ -728,4 +465,295 @@
     return TRUE;
 }
 
-
+/************************************************************************/
+/* DxEngNUIsTermSrv                                                     */
+/************************************************************************/
+
+/* Notes : Check see if termal server got a connections or not */
+BOOL
+DxEngNUIsTermSrv()
+{
+    /* FIXME ReactOS does not suport terminal server yet, we can not check if we got a
connections or not */
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngRedrawDesktop                                                   */
+/************************************************************************/
+
+/* Notes : it always return TRUE, and it update whole the screen (redaw current desktop)
*/
+BOOL
+DxEngRedrawDesktop()
+{
+    /* FIXME add redraw code */
+    UNIMPLEMENTED;
+    return TRUE;
+}
+ULONG gulVisRgnUniqueness; // Increase count everytime client region is updated.
+
+/************************************************************************/
+/* DxEngVisRgnUniq                                                      */
+/************************************************************************/
+/* Notes :  return the VisRgnUniq counter for win32k */
+ULONG
+DxEngVisRgnUniq()
+{
+    return gulVisRgnUniqueness;
+}
+
+/************************************************************************/
+/* DxEngEnumerateHdev                                                   */
+/************************************************************************/
+/* Enumerate all drivers in win32k */
+HDEV *
+DxEngEnumerateHdev(HDEV *hdev)
+{
+    /* FIXME Enumerate all drivers in win32k */
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngCreateMemoryDC                                                  */
+/************************************************************************/
+DWORD DxEngCreateMemoryDC(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngScreenAccessCheck                                               */
+/************************************************************************/
+DWORD DxEngScreenAccessCheck()
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngLockHdev                                                        */
+/************************************************************************/
+DWORD DxEngLockHdev(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngUnlockHdev                                                      */
+/************************************************************************/
+DWORD DxEngUnlockHdev(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngReferenceHdev                                                   */
+/************************************************************************/
+DWORD DxEngReferenceHdev(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngIsHdevLockedByCurrentThread                                     */
+/************************************************************************/
+DWORD DxEngIsHdevLockedByCurrentThread(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+
+/************************************************************************/
+/* DxEngUnreferenceHdev                                                 */
+/************************************************************************/
+DWORD DxEngUnreferenceHdev(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngGetDesktopDC                                                    */
+/************************************************************************/
+DWORD DxEngGetDesktopDC(DWORD x1, DWORD x2, DWORD x3)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngDeleteDC                                                        */
+/************************************************************************/
+DWORD DxEngDeleteDC(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngCleanDC                                                         */
+/************************************************************************/
+BOOLEAN DxEngCleanDC(HDC hdc)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSetDCOwner                                                      */
+/************************************************************************/
+DWORD DxEngSetDCOwner(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSetDCState                                                      */
+/************************************************************************/
+DWORD DxEngSetDCState(DWORD x1, DWORD x2, DWORD x3)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSelectBitmap                                                    */
+/************************************************************************/
+DWORD DxEngSelectBitmap(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSetBitmapOwner                                                  */
+/************************************************************************/
+DWORD DxEngSetBitmapOwner(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngDeleteSurface                                                   */
+/************************************************************************/
+DWORD DxEngDeleteSurface(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngGetSurfaceData                                                  */
+/************************************************************************/
+DWORD DxEngGetSurfaceData(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngAltLockSurface                                                  */
+/************************************************************************/
+DWORD DxEngAltLockSurface(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngUploadPaletteEntryToSurface                                     */
+/************************************************************************/
+DWORD DxEngUploadPaletteEntryToSurface(DWORD x1, DWORD x2,DWORD x3, DWORD x4)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngMarkSurfaceAsDirectDraw                                         */
+/************************************************************************/
+DWORD DxEngMarkSurfaceAsDirectDraw(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSelectPaletteToSurface                                          */
+/************************************************************************/
+DWORD DxEngSelectPaletteToSurface(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSyncPaletteTableWithDevice                                      */
+/************************************************************************/
+DWORD DxEngSyncPaletteTableWithDevice(DWORD x1, DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSetPaletteState                                                 */
+/************************************************************************/
+DWORD DxEngSetPaletteState(DWORD x1, DWORD x2, DWORD x3)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngGetRedirectionBitmap                                            */
+/************************************************************************/
+DWORD DxEngGetRedirectionBitmap(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngLoadImage                                                       */
+/************************************************************************/
+DWORD DxEngLoadImage(DWORD x1,DWORD x2)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSpTearDownSprites                                               */
+/************************************************************************/
+DWORD DxEngSpTearDownSprites(DWORD x1, DWORD x2, DWORD x3)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSpUnTearDownSprites                                             */
+/************************************************************************/
+DWORD DxEngSpUnTearDownSprites(DWORD x1, DWORD x2, DWORD x3)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}
+
+/************************************************************************/
+/* DxEngSpSpritesVisible                                                */
+/************************************************************************/
+DWORD DxEngSpSpritesVisible(DWORD x1)
+{
+    UNIMPLEMENTED;
+    return FALSE;
+}