PFN_DrvEnableDriver

DrvEnableDriver 関数は、ドライバー DLL がエクスポートする最初のドライバーエントリポイントです。この関数は、DRVENABLEDATA 構造体に、ドライバーのグラフィックス DDI バージョン番号と、ドライバーがサポートするすべてのグラフィックス DDI 関数の呼び出しアドレスを格納します。

指定されたドライバーが有効になった場合、戻り値は TRUE です。それ以外の場合は FALSE となり、エラーコードがログに記録されます。

DrvEnableDriver は、すべてのグラフィックスドライバーで実装する必要があります。Windows Driver Kit (WDK) のビルドツールを使用し、TARGETTYPE に GDI_DRIVER を設定している場合 (Building a Printer Graphics DLL を参照)、この関数の名前は DrvEnableDriver でなければなりません。名前でアクセスする必要があるディスプレイドライバー関数は、これだけです。その他のディスプレイドライバー関数はすべて関数ポインター経由でアクセスされるため、このドキュメントでは、それらの名前を仮の名前として示しています。

セマフォの割り当てなど、一度だけ行う初期化処理も、この関数で実行できます。ディスプレイなどのハードウェアを有効にするのは、DrvEnablePDEV が呼び出されるまで待つ必要があります。

iEngineVersion で渡される値を使用してバージョンを確認する場合、ドライバーは次の表に示す適切な DDI_DRIVER_VERSION_Xxx 定数 (winddi.h で定義) を使用してください。今後も新しいバージョンやオペレーティングシステムのサービスパックがリリースされるため、ドライバーは等価比較だけで判定することのないようにしてください。詳細については、DRVENABLEDATA を参照してください。