DIF_UNREMOVE
Eine DIF_UNREMOVE Anforderung benachrichtigt das Installationsprogramm, dass Windows ein Gerät in einem bestimmten Hardwareprofil wiederhergestellt hat, und gibt dem Installationsprogramm die Möglichkeit, am Vorgang teilzunehmen. Windows sendet diese Anforderung nur für Nicht-PnP-Geräte.
Sendebedingungen
Wenn ein root-enumeriertes Nicht-PnP-Gerät in einem Hardwareprofil wiederhergestellt wird.
Wer behandelt
Klassen-Co-Installer |
Kann verarbeiten |
Geräte-Co-Installer |
Kann verarbeiten |
Klasseninstallationsprogramm |
Kann verarbeiten |
Eingabe des Installationsprogramms
DeviceInfoSet
Stellt ein Handle für den Geräteinformationssatz bereit , der das Gerät enthält.
DeviceInfoData
Stellt einen Zeiger auf eine SP_DEVINFO_DATA-Struktur bereit, die das Gerät im Geräteinformationssatz identifiziert.
Geräteinstallationsparameter
DeviceInfoData sind Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) zugeordnet.
Klasseninstallationsparameter
DeviceInfoData ist eine SP_UNREMOVEDEVICE_PARAMS-Struktur zugeordnet. Das Feld Bereich muss auf DI_UNREMOVEDEVICE_CONFIGSPECIFIC festgelegt werden, und im Feld HwProfile muss ein Hardwareprofil angegeben werden.
Installationsprogrammausgabe
Rückgabewert des Installers
Ein Co-Installer kann NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED oder einen Win32-Fehlercode zurückgeben.
Wenn ein Klasseninstallationsprogramm diese Anforderung erfolgreich verarbeitet und SetupDiCallClassInstaller anschließend den Standardhandler aufrufen sollte, gibt das Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT zurück.
Wenn der Klasseninstaller diese Anforderung erfolgreich verarbeitet, einschließlich des direkten Aufrufs des Standardhandlers, sollte der Klasseninstaller NO_ERROR zurückgeben, und SetupDiCallClassInstaller ruft den Standardhandler anschließend nicht mehr auf.
Hinweis Der Klasseninstaller kann den Standardhandler direkt aufrufen, aber der Klasseninstaller sollte niemals versuchen, die Vorgänge des Standardhandlers abzulösen.
Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.
Wenn beim Klasseninstallationsprogramm ein Fehler auftritt, sollte das Installationsprogramm einen entsprechenden Win32-Fehlercode zurückgeben, und SetupDiCallClassInstaller ruft anschließend nicht den Standardhandler auf.
Standard-DIF-Codehandler
Installer-Vorgang
"Entfernen" eines Geräts bedeutet im Wesentlichen, dass Windows ein Flag löscht, das ein Gerät zuvor in einem bestimmten Hardwareprofil als "nicht vorhanden" markiert hat.
Weitere Informationen zu DIF-Codes finden Sie unter Behandeln von DIF-Codes.
Requirements (Anforderungen)
Version |
Unterstützt in Microsoft Windows 2000 und höheren Versionen von Windows. |
Header |
Setupapi.h (schließen Sie Setupapi.h ein) |