DrvEnableDriver 函式 (winddi.h)

發行項
03/04/2024

DrvEnableDriver 函式是由驅動程式 DLL 導出的初始驅動程式進入點。它會填入 DRVENABLEDATA 結構，其中包含驅動程式的圖形 DDI 版本號碼，以及驅動程式所支援之所有圖形 DDI 函式的呼叫位址。

語法

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

參數

iEngineVersion

識別目前正在執行的 GDI 版本。

cj

這是 pded 所指向之結構位元組的大小。如果結構大於預期，則應該保留未修改的額外成員。

[in] pded

DRVENABLEDATA 結構的指標。 GDI 零會先初始化 cj 位元組，再呼叫。驅動程式會填入自己的數據。

傳回值

如果啟用指定的驅動程式，則傳回值為 TRUE 。否則，它會是 FALSE，並記錄錯誤碼。

備註

DrvEnableDriver 必須在所有圖形驅動程序中實作。如果您使用 Windows 驅動程式套件 (WDK) 建置工具，並將 TARGETTYPE 設定為 GDI_DRIVER (请参阅建置印表機圖形 DLL) ，此函式必須命名為 DrvEnableDriver。這是唯一必須依名稱存取的顯示驅動程式函式。所有其他顯示驅動程式函式都是透過函式指標來存取;因此，其名稱會以虛擬名稱的形式呈現在此檔中。

此函式也可以執行一次性初始化，例如配置旗號。驅動程式應該等到在啟用硬體之前呼叫 DrvEnablePDEV ，例如顯示器。

使用iEngineVersion 中提供的值執行版本檢查時，驅動程序應該使用在winddi.) h 中定義的適當DDI_DRIVER_VERSION_Xxx 常數 (，如下表所示。驅動程式應該幾乎永遠不會檢查是否相等，因為新版本和操作系統的 Service Pack 版本將會在未來發行。如需詳細資訊，請參閱 DRVENABLEDATA。

值	作業系統版本
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1