WdfPreDeviceInstall-Funktion (wdfinstaller.h)

  • Artikel

[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 das Installationsprogramm eines Nicht-Plug & Play -Treibers (PnP) den Kernelmodusdienst des Treibers erstellt.

Syntax

ULONG WdfPreDeviceInstall(
  [in]           LPCWSTR InfPath,
  [in, optional] LPCWSTR InfSectionName
);

Parameter

[in] InfPath

Ein Zeiger auf eine mit NULL beendete Breitzeichenzeichenfolge, die den Verzeichnispfad zur INF-Datei des Treibers enthält. Das Installationsprogramm des Treibers kann diese Zeichenfolge abrufen, indem GetCurrentDirectory aufgerufen wird, was im Microsoft Windows SDK beschrieben wird.

[in, optional] InfSectionName

Ein Zeiger auf eine mit NULL beendete 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

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.

Hinweise

Das Installationsprogramm für die frameworkbasierten Treiber eines Nicht-PnP-Geräts muss WdfPreDeviceInstall oder WdfPreDeviceInstallEx aufrufen, bevor das Installationsprogramm CreateService aufruft.

Um die Adresse der WdfPreDeviceInstall-Funktion des Co-Installers abzurufen, muss der Installer GetProcAddress aufrufen, nachdem das Installationsprogramm LoadLibrary aufgerufen hat, um den Co-Installer zu laden.

Wenn das Co-Installationsprogramm feststellt, dass der Computer neu gestartet werden muss, um die Treiberinstallation abzuschließen (in der Regel, weil zuvor eine ältere Version des Frameworks installiert wurde), informiert WdfPreDeviceInstall den Plug & Play -Manager (PnP). Der PnP-Manager fordert den Benutzer dann auf, dass ein Neustart erforderlich ist.

Weitere Informationen zur WdfPreDeviceInstall-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 Funktion WdfPreDeviceInstall verwendet, finden Sie im Installationsprogramm für das NONPNP-Beispiel .

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfinstaller.h (einschließen von Wdfinstaller.h)
Bibliothek N/A (Wird von der KMDF-Co-Installer-Bibliothek exportiert. Informationen zum Dateinamen der Co-Installer-Bibliothek finden Sie unter Verwenden des KMDF-Co-Installers.)

Weitere Informationen

WdfPostDeviceInstall