reactos操作系统实现(189)

DC（device context）是一个图形对象、图形属性和影响图形输出的集合结构体。CreateDC函数用给定名称为指定的设备创建设备环境。CreateDC一般用于创建打印机的设备环境，也可以用来得到屏幕（硬件屏幕，而不是窗口的客户区）的设备环境。请小心使用这个函数，因为它允许应用程序在屏幕上任何位置绘图，而不仅仅是在窗口的边界内。请用GetDC或BeginPaint来获取屏幕窗口的设备环境。

#001  HDC

#002  WINAPI

#003  CreateDCW (

#004       LPCWSTR           lpwszDriver,

#005       LPCWSTR           lpwszDevice,

#006       LPCWSTR           lpwszOutput,

#007       CONST DEVMODEW  *lpInitData

#008       )

#009  {

#010 

#011   return  IntCreateDICW ( lpwszDriver,

#012                           lpwszDevice,

#013                           lpwszOutput,

#014                (PDEVMODEW) lpInitData,

#015                                     0 );

#016  }

lpwszDriver是指向空值结尾的字符串的指针，字符串说明设备驱动程序的文件名。比如“DISPLAY”指的是显示器驱动程序，而“WINSPOOL”就是指打印驱动程序。

lpwszDevice是批向空值结尾的字符串的指针，字符串指定了正在使用的专用输出设备的名称，比如打印管理程序名称。

lpwszOutput是没有使用参数，一般设置为NULL。

lpInitData是指向结构包含了设备驱动程序的设备专用初始化数据。设置为NULL时，就使用系统默认的初始化参数。

 

下面接着来分析函数IntCreateDICW的代码：

#001  HDC

#002  FASTCALL

#003  IntCreateDICW ( LPCWSTR   lpwszDriver,

#004                  LPCWSTR   lpwszDevice,

#005                  LPCWSTR   lpwszOutput,

#006                  PDEVMODEW lpInitData,

#007                  ULONG     iType )

#008  {

#009   UNICODE_STRING Device, Output;

#010   HDC hDC = NULL;

#011   BOOL Display = FALSE, Default = TRUE;

#012   ULONG UMdhpdev = 0;

#013 

#014   HANDLE hspool = NULL;

#015 

 

加载打印驱动程序。

#016   if ( !ghSpooler && !LoadTheSpoolerDrv())

#017   {

#018      DPRINT1("WinSpooler.Drv Did not load!/n");

#019   }

#020   else

#021   {

#022      DPRINT("WinSpooler.Drv Loaded! hMod -> 0x%x/n", ghSpooler);

#023   }

#024 

 

根据设备名称判断获取什么样的设备。

#025   if ((!lpwszDevice) && (!lpwszDriver))

#026   {

 

设置缺省设备名称。

#027       Default = FALSE;  // Ask Win32k to set Default device.

#028       Display = TRUE;   // Most likely to be DISPLAY.

#029   }

#030   else

#031   {

#032      if ((lpwszDevice) && (wcslen(lpwszDevice) != 0))  // First

#033      {

 

判断是否获取显示设备。

#034        if (!_wcsnicmp(lpwszDevice, L"////.//DISPLAY",11)) Display = TRUE;

#035        RtlInitUnicodeString(&Device, lpwszDevice);

#036      }

#037      else

#038      {

#039        if (lpwszDriver) // Second

#040        {

#041          if ((!_wcsnicmp(lpwszDriver, L"DISPLAY",7)) ||

#042                (!_wcsnicmp(lpwszDriver, L"////.//DISPLAY",11))) Display = TRUE;

#043          RtlInitUnicodeString(&Device, lpwszDriver);

#044        }

#045      }

#046   }

#047 

#048   if (lpwszOutput) RtlInitUnicodeString(&Output, lpwszOutput);

#049 

#050   if (!Display)

#051   {

#052      //Handle Print device or something else.

#053      DPRINT1("Not a DISPLAY device! %wZ/n", &Device);

#054   }

#055 

 

调用WIN32K内核NtGdiOpenDCW函数打开设备。

#056   hDC = NtGdiOpenDCW( (Default ? &Device : NULL),

#057                       (PDEVMODEW) lpInitData,

#058                       (lpwszOutput ? &Output : NULL),

#059                        iType,             // DCW 0 and ICW 1.

#060                        Display,

#061                        hspool,

#062                       (PVOID) NULL,       // NULL for now.

#063                       (PVOID) &UMdhpdev );

#064  #if 0

#065  // Handle something other than a normal dc object.

#066   if (GDI_HANDLE_GET_TYPE(hDC) != GDI_OBJECT_TYPE_DC)

#067   {

#068      PDC_ATTR Dc_Attr;

#069      PLDC pLDC;

#070 

#071      GdiGetHandleUserData((HGDIOBJ) hDC, GDI_OBJECT_TYPE_DC, (PVOID) &Dc_Attr);

#072 

#073      pLDC = LocalAlloc(LMEM_ZEROINIT, sizeof(LDC));

#074 

#075      Dc_Attr->pvLDC = pLDC;

#076      pLDC->hDC = hDC;

#077      pLDC->iType = LDC_LDC; // 1 (init) local DC, 2 EMF LDC

#078      DbgPrint("DC_ATTR Allocated -> 0x%x/n",Dc_Attr);

#079   }

#080  #endif

 

返回DC给应用程序。

#081   return hDC;

#082  }