WdfPostDeviceInstall-Funktion (wdfinstaller.h)

Artikel
03/22/2025

[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 ein Nicht-Plug- und Play-Treiber (PnP) den Kernelmodusdienst des Treibers erstellt hat.

Syntax

ULONG WdfPostDeviceInstall(
  [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

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.hdefiniert sind.

Bemerkungen

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 das Co-Installer zu laden.

Weitere Informationen über die WdfPostDeviceInstall-Funktion und Installationsprogramme 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 WdfPostDeviceInstall--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.)

Siehe auch

WdfPreDeviceInstall-

Freigeben über