DIF_POWERMESSAGEWAKE
Eine DIF_POWERMESSAGEWAKE Anforderung ermöglicht es einem Installationsprogramm, benutzerdefinierten Text anzugeben, den Windows auf der Seite Energieverwaltungseigenschaften der Geräteeigenschaften anzeigt.
Sendebedingungen
Wenn ein Benutzer auf ein Menüelement oder eine Registerkarte klickt, um die Eigenschaften eines Geräts anzuzeigen.
Windows sendet diese DIF-Anforderung nur, wenn die Treiber für das Gerät die Energieverwaltung unterstützen. Andernfalls zeigt Windows keine Energieeigenschaften für das Gerät an.
Wer verarbeitet
Klassen-Co-Installer |
Kann verarbeiten |
Geräte-Co-Installer |
Kann verarbeiten |
Klasseninstallationsprogramm |
Kann verarbeiten |
Installationsprogrammeingabe
DeviceInfoSet
Stellt dem Geräteinformationssatz , der das Gerät enthält, ein Handle bereit.
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_POWERMESSAGEWAKE_PARAMS Struktur zugeordnet.
Installationsprogrammausgabe
Klasseninstallationsparameter
Ein Installationsprogramm kann die SP_POWERMESSAGEWAKE_PARAMS ändern, um benutzerdefinierten Text für die Energieeigenschaftenseite eines Geräts anzugeben.
Installer-Rückgabewert
Ein Co-Installer gibt in der Regel NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED oder einen Win32-Fehlercode zurück.
Ein Klasseninstallationsprogramm gibt NO_ERROR zurück, wenn es erfolgreich Text für Die Energieeigenschaften bereitstellt. Andernfalls gibt ein Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT oder einen Win32-Fehlercode zurück.
Standard-DIF-Codehandler
Keine
Installationsprogrammvorgang
Eine DIF_POWERMESSAGEWAKE Anforderung ermöglicht es einem Installationsprogramm, Text anzugeben, den Windows auf der Seite Energieeigenschaften für ein Gerät anzeigt.
Wenn ein Co-Installationsprogramm Text für Energieeigenschaften bereitstellt, sollte dies in der Nachverarbeitungsphase der Vorgang sein. Ein Co-Installer sollte beim Überschreiben von Power-Properties-Text vorsichtig sein, der von einem Installationsprogramm bereitgestellt wird, das die Anforderung vor dem Co-Installer verarbeitet 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 (einschließlich Setupapi.h) |