Aufrufen der DIF-Standardcodehandler

Hinweis

In diesem Abschnitt beschriebene Features werden in universellen oder mobilen Treiberpaketen nicht unterstützt. Weitere Informationen finden Sie unter Verwenden einer universellen INF-Datei.

Standardmäßige DIF-Codehandler führen systemdefinierte Standardvorgänge für DIF-Codes aus. Wie unter Behandeln von DIF-Codes beschrieben, ruft SetupDiCallClassInstaller den Standardhandler für eine DIF-Anforderung auf, nachdem der Klasseninstaller und der Co-Installer die DIF-Anforderung zuerst verarbeitet haben, aber bevor SetupDiCallClassInstaller die Co-Installer zurückruft, die für die Nachverarbeitung der Anforderung registriert wurden.

Hinweis Der Vorgang von SetupDiCallClassInstaller kann nicht so konfiguriert werden, dass der Klasseninstaller zum Nacharbeiten einer DIF-Anforderung aufgerufen wird.

In Den Situationen, in denen ein Klasseninstallationsprogramm Vorgänge für eine DIF-Anforderung ausführen muss, nachdem der Standardhandler aufgerufen wurde, muss der Klasseninstallationsinstaller den Standardhandler direkt aufrufen, wenn er die DIF-Anforderung verarbeitet, wie folgt:

  1. Führen Sie Vorgänge aus, die vor dem Aufrufen des Standardhandlers ausgeführt werden müssen.

  2. Rufen Sie den Standardhandler auf, um die Standardvorgänge auszuführen.

    Hinweis Der Klasseninstaller darf nicht versuchen, den Vorgang des Standardhandlers abzulösen.

  3. Führen Sie die Vorgänge aus, die nach der Rückgabe des Standardhandlers ausgeführt werden müssen.

  4. Gibt NO_ERROR zurück, wenn das Klasseninstallationsprogramm die Verarbeitung der DIF-Anforderung erfolgreich abgeschlossen hat oder einen Win32-Fehler zurückgibt, wenn die Verarbeitung fehlgeschlagen ist.

WichtigCo-Installer und Geräteinstallationsanwendungen dürfen die DIF-Standardcodehandler nicht aufrufen.

Ein Beispiel für eine Situation, in der diese Methode verwendet werden muss, finden Sie in den Informationen zum Aufrufen des Standardhandlers SetupDiInstallDevice auf der DIF_INSTALLDEVICE-Anforderungsreferenzseite.

In der folgenden Tabelle sind die DIF-Codes aufgeführt, die Über Standardhandler verfügen.

DIF-Code DIF-Standardcodehandlerfunktion
DIF_PROPERTYCHANGE SetupDiChangeState
DIF_FINISHINSTALL_ACTION SetupDiFinishInstallAction
DIF_INSTALLDEVICE SetupDiInstallDevice
DIF_INSTALLINTERFACES SetupDiInstallDeviceInterfaces
DIF_INSTALLDEVICEFILES SetupDiInstallDriverFiles
DIF_REGISTER_COINSTALLERS SetupDiRegisterCoDeviceInstallers
DIF_REGISTERDEVICE SetupDiRegisterDeviceInfo
DIF_REMOVE SetupDiRemoveDevice
DIF_SELECTBESTCOMPATDRV SetupDiSelectBestCompatDrv
DIF_SELECTDEVICE SetupDiSelectDevice
DIF_UNREMOVE SetupDiUnremoveDevice