驱动开发之六 --- 一个简单的显示驱动之五 【译文】

驱动开发之六 --- 一个简单的显示驱动之五 【译文】

DrvCompletePDEV

DrvCompletePDEV的调用，是用在DrvEnablePDEV调用之后，用来通知显示驱动，设备对象现在已经完成。仅有的参数是一个私有的在DrvEnablePDEV调用中创建的数据结构和一个指向GDI设备的完成句柄。除非你有更多的初始化要做，否则通常的做法是保存这个gdi句柄，然后继续。下面的代码来自于例子驱动。

/*********************************************************************

* GdiExample_DrvCompletePDEV

*

* This is called to complete the process of enabling the device.

*

*

*********************************************************************/

void GdiExample_DrvCompletePDEV(DHPDEV dhpdev, HDEV hdev)

{

PDEVICE_DATA pDeviceData = (PDEVICE_DATA)dhpdev;

ENGDEBUGPRINT(0, "GdiExample_DrvCompletePDEV Enter \r\n", NULL);

pDeviceData->hdev = hdev;

ENGDEBUGPRINT(0, "GdiExample_DrvCompletePDEV Exit \r\n", NULL);

}

DrvDisablePDEV

当这个PDEV不再需要的时候，调用这个api消灭。如果还有一个表面使能，这个API调用之前，需要调用DrvDisableSurface。这个api我们实现得很简单，仅仅是执行了一些清理工作，清理了在创建私有的PDEV结构期间创建的东西。

/*********************************************************************

* GdiExample_DrvDisablePDEV

*

* This is called to disable the PDEV we created.

*

*

*********************************************************************/

void GdiExample_DrvDisablePDEV(DHPDEV dhpdev)

{

PDEVICE_DATA pDeviceData = (PDEVICE_DATA)dhpdev;

UINT dwBytesReturned = 0;

ENGDEBUGPRINT(0, "GdiExample_DrvDisablePDEV\r\n", NULL);

if(pDeviceData->pMappedFile)

{

EngUnmapFile(pDeviceData->pMappedFile);

}

EngFreeMem(dhpdev);

}

DrvEnableSurface

这个api是用在PDEV完成以后，用来请求显示驱动创建一个表面。当创建一个表面的时候，注意你可以有两种选择。你可以创建一个由显示驱动管理的表面，也可以创建一个由GDI管理的表面。下面的代码选择一个选项来管理它自己的设备表面。

整个的用途就是定义有一个绘画表面，GDI也能在上面绘制。显示驱动有他们自己的设备表面，因此通常需要管理自己的表面。在做这个事情时，它需要以某种方式来描述这个表面，以使GDI能够理解，并能够在上面绘制。这意味着起始地址甚至是显示程度的定义，作为显示驱动对所有的显示模式一般都不能有线性缓冲。在我们这个例子中，我们使用我们创建的内存映像文件来作为我们的视频内存。

/*********************************************************************

* GdiExample_DrvEnableSurface

*

* This API is used to enable the physical device surface.

*

* You have two choices here.

*

* 1. Driver Manages it's own surface

* EngCreateDeviceSurface - Create the handle

* EngModifySurface - Let GDI Know about the object.

*

* 2. GDI Manages the surface

* EngCreateBitmap - Create a handle in a format that

* GDI Understands

* EngAssociateSurface - Let GDI Know about the object.

*

*

*********************************************************************/

HSURF GdiExample_DrvEnableSurface(DHPDEV dhpdev)

{

HSURF hsurf;

SIZEL sizl;

PDEVICE_DATA pDeviceData = (PDEVICE_DATA)dhpdev;



ENGDEBUGPRINT(0, "GdiExample_DrvEnableSurface\r\n", NULL);

pDeviceData->pDeviceSurface =

(PDEVICE_SURFACE)EngAllocMem(FL_ZERO_MEMORY,

sizeof(DEVICE_SURFACE), FAKE_GFX_TAG);

sizl.cx = 800;

sizl.cy = 600;

hsurf = (HSURF)EngCreateDeviceSurface(

(DHSURF)pDeviceData->pDeviceSurface, sizl, BMF_32BPP);



EngModifySurface(hsurf, pDeviceData->hdev,

HOOK_FILLPATH | HOOK_STROKEPATH | HOOK_LINETO |

HOOK_TEXTOUT | HOOK_BITBLT | HOOK_COPYBITS,

MS_NOTSYSTEMMEMORY, (DHSURF)pDeviceData->pDeviceSurface,

pDeviceData->pVideoMemory, 800*4, NULL);



return(hsurf);

}

DrvDisableSurface

调用这个api用来注销在DrvEnableSurface调用中创建的绘画表面。这个在注销PDEV之前调用。下面的代码来自于示例程序。

/*********************************************************************

* GdiExample_DrvDisableSurface

*

* This API is called to disable the GDI Surface.

*

*

*********************************************************************/

void GdiExample_DrvDisableSurface(DHPDEV dhpdev)

{

PDEVICE_DATA pDeviceData = (PDEVICE_DATA)dhpdev;

ENGDEBUGPRINT(0, "GdiExample_DrvDisableSurface\r\n", NULL);

EngDeleteSurface(pDeviceData->hsurf);

pDeviceData->hsurf = NULL;

EngFreeMem(pDeviceData->pDeviceSurface);

pDeviceData->pDeviceSurface = NULL;

}