DrvEnableDriver 関数 (winddi.h)

[アーティクル]
08/27/2023

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 Driver Kit (WDK) ビルドツールを使用し、TARGETTYPE を GDI_DRIVER に設定している場合 (「プリンターグラフィックス DLL のビルド」を参照)、この関数の名前は DrvEnableDriver にする必要があります。これは、名前でアクセスする必要がある唯一のディスプレイドライバー関数です。その他のすべてのディスプレイドライバー関数は、関数ポインターを介してアクセスされます。したがって、これらの名前は、このドキュメントでは擬似名として示されています。

この関数では、セマフォの割り当てなどの 1 回限りの初期化を実行することもできます。ドライバーは、ディスプレイなどのハードウェアを有効にする前に、DrvEnablePDEV が呼び出されるまで待機する必要があります。

iEngineVersion で指定された値を使用してバージョンチェックを実行する場合、ドライバーは次の表に示す適切な DDI_DRIVER_VERSION_Xxx 定数 (winddi.h で定義) を使用する必要があります。ドライバーは、オペレーティングシステムの新しいバージョンとサービスパックのリリースが将来リリースされるため、同等のためだけにチェックすることはほとんどありません。詳細については、「 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