WdfPostDeviceRemove-Funktion (wdfinstaller.h)
[Gilt nur für KMDF]
Die WdfPostDeviceRemove-Funktion des Co-Installers führt alle Vorgänge aus, die das Co-Installationsprogramm möglicherweise erfordert, nachdem das Installationsprogramm eines nicht Plug & Play Treibers (PnP) den Kernelmodusdienst des Treibers gelöscht hat.
Syntax
ULONG WdfPostDeviceRemove(
[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
WdfPostDeviceRemove 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 WdfPostDeviceRemove aufrufen, nachdem das Installationsprogramm DeleteService aufgerufen hat.
Um die Adresse der WdfPostDeviceRemove-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 WdfPostDeviceRemove-Funktion und zu Installationsprogrammen für frameworkbasierte Treiber von Nicht-PnP-Geräten finden Sie unter Installieren eines Nicht-PnP-Treibers. Weitere Informationen zu DeleteService, GetProcAddress und LoadLibrary finden Sie in der dokumentation zu Microsoft Windows SDK.
Beispiele
Ein Codebeispiel, das die Funktion WdfPostDeviceRemove 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.) |