Freigeben über


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)

Weitere Informationen

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_POWERMESSAGEWAKE_PARAMS