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。