WdfPostDeviceInstall-Funktion (wdfinstaller.h)
[Gilt nur für KMDF]
Die WdfPostDeviceInstall-Funktion des Co-Installers führt alle Vorgänge aus, die der Co-Installer möglicherweise erfordert, nachdem das Installationsprogramm eines nicht Plug & Play Treibers (PnP) den Kernelmodusdienst des Treibers erstellt hat.
Syntax
ULONG WdfPostDeviceInstall(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName
);
Parameter
[in] InfPath
Ein Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die den Verzeichnispfad zur INF-Datei des Treibers enthält. Das Installationsprogramm des Treibers kann diese Zeichenfolge abrufen, indem GetCurrentDirectory aufgerufen wird, was in der Microsoft Windows SDK beschrieben wird.
[in, optional] InfSectionName
Ein Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die den Wdf-install-section-Namen in der INF-Datei des Treibers enthält. Weitere Informationen zu diesem Namen finden Sie unter Verwenden des KMDF-Co-Installers. Wenn dieser Zeiger NULL ist, verwendet das Co-Installationsprogramm WdfSection als Namen.
Rückgabewert
WdfPostDeviceInstall 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.
Hinweise
Das Installationsprogramm für die frameworkbasierten Treiber eines Nicht-PnP-Geräts muss WdfPostDeviceInstall aufrufen, nachdem das Installationsprogramm CreateService aufgerufen hat.
Um die Adresse der WdfPostDeviceInstall-Funktion des Co-Installers abzurufen, muss das Installationsprogramm GetProcAddress aufrufen, nachdem das Installationsprogramm LoadLibrary aufgerufen hat, um den Co-Installer zu laden.
Weitere Informationen zur WdfPostDeviceInstall-Funktion und zu Installationsprogrammen für frameworkbasierte Treiber von Nicht-PnP-Geräten finden Sie unter Installieren eines Nicht-PnP-Treibers. Weitere Informationen zu CreateService, GetProcAddress und LoadLibrary finden Sie in der Microsoft Windows SDK-Dokumentation.
Beispiele
Ein Codebeispiel, das die WdfPostDeviceInstall-Funktion verwendet, finden Sie im Installationsprogramm für das NONPNP-Beispiel .
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
Kopfzeile | wdfinstaller.h (include Wdfinstaller.h) |
Bibliothek | N/V (Wird von der KMDF-Co-Installer-Bibliothek exportiert. Informationen zum Dateinamen der Co-Installer-Bibliothek finden Sie unter Verwenden des KMDF-Co-Installers.) |