DIF_PROPERTYCHANGE

Artikel
06/14/2023

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

Nichts

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

SetupDiChangeState

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.