WdfPreDeviceInstallEx-Funktion (wdfinstaller.h)
[Gilt nur für KMDF]
Die WdfPreDeviceInstallEx--Funktion des Co-Installers führt alle Vorgänge aus, die der Co-Installer möglicherweise erfordert, bevor ein Nicht-Plug and Play(PnP)-Treiberinstallationsprogramm den Kernelmodusdienst des Treibers erstellt.
Syntax
ULONG WdfPreDeviceInstallEx(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName,
[in] PWDF_COINSTALLER_INSTALL_OPTIONS ClientOptions
);
Die Parameter
[in] InfPath
Ein Zeiger auf eine mit Null beendete Zeichenfolge mit breitem Zeichen, die den Verzeichnispfad zur INF-Datei des Treibers enthält. Das Installationsprogramm des Treibers kann diese Zeichenfolge abrufen, indem GetCurrentDirectoryaufgerufen wird, das im Microsoft Windows SDK beschrieben wird.
[in, optional] InfSectionName
Ein Zeiger auf eine mit Null beendete Zeichenfolge mit breitem Zeichen, die den Wdf-install-section Namen in der INF-Datei des Treibers enthält. Weitere Informationen zu diesem Namen finden Sie unter Using the KMDF Co-installer. Wenn dieser Zeiger NULL-ist, verwendet das Co-Installer WdfSection- für den Namen.
[in] ClientOptions
Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_COINSTALLER_INSTALL_OPTIONS-typierte Struktur, die treiberspezifische Installationsoptionen enthält.
Rückgabewert
WdfPreDeviceInstallEx gibt ERROR_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der zusätzlichen ERROR_XXX--Werte zurück, die in Winerror.hdefiniert sind.
Bemerkungen
Das Installationsprogramm für die frameworkbasierten Treiber eines Nicht-PnP-Geräts muss WdfPreDeviceInstall oder WdfPreDeviceInstallEx aufrufen, bevor das Installationsprogramm CreateServiceaufruft.
Um die Adresse der WdfPreDeviceInstallEx--Funktion des Co-Installers abzurufen, muss das Installationsprogramm GetProcAddress aufrufen, nachdem das Installationsprogramm LoadLibrary aufgerufen hat, um das Co-Installer zu laden.
Wenn das Co-Installer feststellt, dass der Computer neu gestartet werden muss, um die Treiberinstallation abzuschließen (in der Regel weil eine ältere Version des Frameworks zuvor installiert wurde), können Sie mit der WdfPreDeviceInstallEx--Funktion steuern, wann oder ob der Benutzer aufgefordert wird, den Computer neu zu starten, wie folgt:
- Wenn das Installationsprogramm die ShowRebootPrompt Mitglied der WDF_COINSTALLER_INSTALL_OPTIONS Struktur auf TRUE, WdfPreDeviceInstallEx informiert den PnP-Manager darüber, dass der Computer neu gestartet werden muss, und der PnP-Manager fordert den Benutzer auf, einen Neustart erforderlich zu machen. Das Festlegen des ShowRebootPrompt Member auf TRUE entspricht dem Aufrufen WdfPreDeviceInstall.
- Wenn das Installationsprogramm den ShowRebootPrompt Member der WDF_COINSTALLER_INSTALL_OPTIONS Struktur auf FALSEfestlegt, informiert WdfPreDeviceInstallEx den PnP-Manager nicht darüber, dass ein Neustart erforderlich ist. Stattdessen gibt die Funktion ERROR_SUCCESS_REBOOT_REQUIREDzurück. Das Installationsprogramm kann bestimmen, wann oder ob der Computer neu gestartet werden soll.
Beispiele
Ein Codebeispiel, das die WdfPreDeviceInstallEx--Funktion verwendet, finden Sie im Installationsprogramm für das NONPNP--Beispiel.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.9 |
| Kopfzeile | wdfinstaller.h (include Wdfinstaller.h) |
| Bibliothek | N/A (Exportiert durch die KMDF-Co-Installer-Bibliothek. Informationen zum Dateinamen der Co-Installer-Bibliothek finden Sie unter Verwenden des KMDF-Co-Installers.) |