WdfPreDeviceRemove 関数 (wdfinstaller.h)
[KMDF にのみ適用]
共同インストーラーの WdfPreDeviceRemove 関数は、非プラグ アンド プレイ (PnP) ドライバーのインストーラーがドライバーのカーネル モード サービスを削除する前に、共同インストーラーが必要とするすべての操作を実行します。
構文
ULONG WdfPreDeviceRemove(
[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 を使用します。
戻り値
WdfPreDeviceRemove は、操作 が成功した場合にERROR_SUCCESS を返します。 それ以外の場合、関数は Winerror.h で定義されている追加の ERROR_XXX 値のいずれかを返します。
注釈
PnP 以外のデバイスのフレームワーク ベースのドライバーのインストーラーは、インストーラーが DeleteService を呼び出す前に WdfPreDeviceRemove を呼び出す必要があります。
共同インストーラーの WdfPreDeviceRemove 関数のアドレスを取得するには、インストーラーが LoadLibrary を呼び出して共同インストーラーを読み込んだ後、インストーラーで GetProcAddress を呼び出す必要があります。
PnP 以外のデバイスのフレームワーク ベースのドライバーの WdfPreDeviceRemove 関数とインストーラーの詳細については、「非 PnP ドライバーのインストール」を参照してください。 DeleteService、GetProcAddress、LoadLibrary の詳細については、Microsoft Windows SDKドキュメントを参照してください。
例
WdfPreDeviceRemove 関数を使用するコード例については、NONPNP サンプルのインストーラーを参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfinstaller.h (Wdfinstaller.h を含む) |
| Library | N/A (KMDF 共同インストーラー ライブラリによってエクスポートされます。共同インストーラー ライブラリのファイル名の詳細については、「KMDF 共同インストーラーの使用」を参照してください)。 |