WdfPreDeviceInstall-Funktion (wdfinstaller.h)
[Gilt nur für KMDF]
Die WdfPreDeviceInstall--Funktion des Co-Installers führt alle Vorgänge aus, die der Co-Installer möglicherweise erfordert, bevor ein Nicht-Plug- und Play-Treiber (PnP)-Treiber den Kernelmodusdienst des Treibers erstellt.
Syntax
ULONG WdfPreDeviceInstall(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName
);
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.
Rückgabewert
WdfPreDeviceInstall 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.h definiert 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 WdfPreDeviceInstall-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), WdfPreDeviceInstall informiert den Plug and Play (PnP)-Manager. Der PnP-Manager fordert dann den Benutzer auf, dass ein Neustart erforderlich ist.
Weitere Informationen zu den WdfPreDeviceInstall Funktion und Installationsprogrammen für frameworkbasierte Treiber von Nicht-PnP-Geräten finden Sie unter Installieren eines Nicht-PnP-Treibers. Weitere Informationen zu CreateService, GetProcAddressund LoadLibraryfinden Sie in der Microsoft Windows SDK-Dokumentation.
Beispiele
Ein Codebeispiel, das die WdfPreDeviceInstall--Funktion verwendet, finden Sie im Installationsprogramm für das NONPNP--Beispiel.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| 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.) |