DrvEnableDriver

记录 一下打印学习期间需要用到的驱动函数

MSDN英文详解--DrvEnableDriver

                                          DrvEnableDriver

DrvEnableDriver函数是驱动程序DLL导出的初始驱动程序入口点。它用驱动程序支持的图形DDI版本号和所有图形DDI函数的调用地址填充DRVENABLEDATA结构。

语法

BOOL DrvEnableDriver(
  ULONG         iEngineVersion,
  ULONG         cj,
  DRVENABLEDATA *pded
);

参数

iEngineVersion

标识当前运行的GDI版本。

cj

       是pded指向的结构的大小(以字节为单位)。如果结构比预期的大，则不应修改额外的成员。

pded

      指向DRVENABLEDATA结构的指针。GDI 0在调用之前初始化cj字节。驱动程序填充它自己的数据。

返回值

      如果启用指定的驱动程序，返回值为TRUE。否则，它就是FALSE，并记录错误代码。

备注

        DrvEnableDriver必须在所有图形驱动程序中实现。如果您使用Windows驱动程序工具包(WDK)构建工具并将TARGETTYPE设置为GDI_DRIVER(参见构建打印机图形DLL)，则此函数必须命名为DrvEnableDriver。这是惟一一个必须按名称访问的显示驱动程序函数。所有其他显示驱动程序函数都通过函数指针访问;因此，它们的名称在本文档中以假名的形式出现。

       这个函数还可以执行一次性初始化，比如分配信号量。驱动程序应该等到调用DrvEnablePDEV后才启用硬件，比如显示器。

     当使用iEngineVersion中提供的值执行版本检查时，驱动程序应该使用下表中显示的适当的DDI_DRIVER_VERSION_Xxx常量(在winddi.h中定义)。驱动程序几乎不应该只检查是否平等，因为操作系统的新版本和服务包版本将在未来发布。有关更多信息，请参见DRVENABLEDATA。