WdfPreDeviceInstall 関数 (wdfinstaller.h)

[KMDF にのみ適用]

共同インストーラーの WdfPreDeviceInstall 関数は、非プラグ アンド プレイ (PnP) ドライバーのインストーラーがドライバーのカーネル モード サービスを作成する前に、共同インストーラーが必要とするすべての操作を実行します。

構文

ULONG WdfPreDeviceInstall(
  [in]           LPCWSTR InfPath,
  [in, optional] LPCWSTR InfSectionName
);

パラメーター

[in] InfPath

ドライバーの INF ファイルへのディレクトリ パスを含む null で終わるワイド文字列へのポインター。 ドライバーのインストーラーは、Microsoft Windows SDKで説明されている GetCurrentDirectory を呼び出すことで、この文字列を取得できます。

[in, optional] InfSectionName

ドライバーの INF ファイルの Wdf-install-section 名を含む null で終わるワイド文字列へのポインター。 この名前の詳細については、「 KMDF 共同インストーラーの使用」を参照してください。 このポインターが NULL の場合、共同インストーラーは名前に WdfSection を使用します。

戻り値

WdfPreDeviceInstall は 、操作 が成功した場合にERROR_SUCCESS を返します。 それ以外の場合、関数は Winerror.h で定義されている追加の ERROR_XXX 値のいずれかを返します。

注釈

PnP 以外のデバイスのフレームワーク ベースのドライバーのインストーラーは、インストーラーが CreateService を呼び出す前に WdfPreDeviceInstall または WdfPreDeviceInstallEx を呼び出す必要があります。

共同インストーラーの WdfPreDeviceInstall 関数のアドレスを取得するには、インストーラーが LoadLibrary を呼び出して共同インストーラーを読み込んだ後、インストーラーで GetProcAddress を呼び出す必要があります。

共同インストーラーによって、ドライバーのインストールを完了するためにコンピューターを再起動する必要があると判断された場合 (通常は、以前のバージョンのフレームワークが以前にインストールされていたため)、WdfPreDeviceInstall は プラグ アンド プレイ (PnP) マネージャーに通知します。 PnP マネージャーは、再起動が必要であることをユーザーに求めます。

PnP 以外のデバイスのフレームワーク ベースのドライバーの WdfPreDeviceInstall 関数とインストーラーの詳細については、「非 PnP ドライバーのインストール」を参照してください。 CreateService、GetProcAddress、LoadLibrary の詳細については、Microsoft Windows SDKドキュメントを参照してください。

例

WdfPreDeviceInstall 関数を使用するコード例については、NONPNP サンプルのインストーラーを参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
Header	wdfinstaller.h (Wdfinstaller.h を含む)
Library	N/A (KMDF 共同インストーラー ライブラリによってエクスポートされます。共同インストーラー ライブラリのファイル名の詳細については、「KMDF 共同インストーラーの使用」を参照してください)。

こちらもご覧ください

WdfPostDeviceInstall