DIF_PROPERTYCHANGE
Eine DIF_PROPERTYCHANGE Anforderung benachrichtigt das Installationsprogramm, dass sich die Eigenschaften des Geräts ändern. Das Gerät wird aktiviert, deaktiviert, gestartet, beendet, oder ein Element auf einer Eigenschaftenseite wurde geändert. Diese DIF-Anforderung gibt dem Installationsprogramm die Möglichkeit, an der Änderung teilzunehmen.
Sendebedingungen
Wenn ein Gerät aktiviert, deaktiviert, neu gestartet, beendet wird oder seine Eigenschaften geändert wurden.
Windows sendet diese Anforderung beispielsweise, wenn ein Eigenschaftenseitenanbieter das DI_FLAGSEX_PROPCHANGE_PENDING Flag im Feld FlagsEx der SP_DEVINSTALL_PARAMS-Struktur für das Gerät festlegt.
Weitere Informationen zum Erkennen, wann ein Gerät zum ersten Mal gestartet oder anschließend neu gestartet wird, finden Sie im Abschnitt Installationsvorgang.
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 für das Gerät im Geräteinformationssatz bereit.
Geräteinstallationsparameter
DeviceInfoData sind Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) zugeordnet.
Klasseninstallationsparameter
DeviceInfoData ist eine SP_PROPCHANGE_PARAMS-Struktur zugeordnet.
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
Als Reaktion auf eine DIF_PROPERTYCHANGE Anforderung kann ein Installationsprogramm am Eigenschaftsänderungsvorgang teilnehmen. Die Klasseninstallationsparameter (SP_PROPCHANGE_PARAMS) geben an, welche Änderung stattfindet.
Eine Eigenschaftsänderung erfordert möglicherweise einen Systemneustart. Informationen zum Neustarten des Systems finden Sie unter SetupDiCallClassInstaller.
Wenn Windows eine DIF_INSTALLDEVICE-Anforderung zum erstmaligen Installieren eines Geräts sendet, startet Windows das Gerät, sendet jedoch keine DIF_PROPERTYCHANGE Anforderung im Rahmen der Installation. Wenn ein benutzerdefinierter Installationsvorgang ausgeführt werden muss, wenn ein Gerät zum ersten Mal gestartet wird und das Gerät anschließend neu gestartet wird, sollte ein Installationsprogramm oder ein Co-Installer die DIF_INSTALLDEVICE Anforderung verarbeiten, die das Gerät zum ersten Mal startet, und eine DIF_PROPERTYCHANGE Anforderung, die angibt, dass die Zustandsänderungsaktion darauf hinweist, dass das Gerät gestartet wird.
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) |