WdfDeviceInitSetPowerInrush-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceInitSetPowerInrush-Methode informiert den Energie-Manager darüber, dass das angegebene Gerät beim Starten einen Stromstrom benötigt.
Syntax
void WdfDeviceInitSetPowerInrush(
[in] PWDFDEVICE_INIT DeviceInit
);
Parameter
[in] DeviceInit
Ein vom Aufrufer bereitgestellter Zeiger auf eine WDFDEVICE_INIT-Struktur .
Rückgabewert
Keine
Bemerkungen
Um zu vermeiden, dass die Stromversorgung des Systems überlastet wird, startet das System Geräte, die einen Stromeinstrom nacheinander benötigen.
Wenn Ihr Treiber WdfDeviceInitSetPowerInrush aufruft, wird es durch das Framework nicht auslagerungsfähig , und der Treiber darf WdfDeviceInitSetPowerPageable nicht aufrufen.
Ihr Treiber muss WdfDeviceInitSetPowerInrush aufrufen, bevor er WdfDeviceCreate aufruft. Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.
Das Aufrufen von WdfDeviceInitSetPowerInrush über einen Filtertreiber hat keine Auswirkung. Für Filtertreiber verwendet das Framework die Einstellung, die der nächstniedrige Treiber im Treiberstapel angibt.
Beispiele
Im folgenden Codebeispiel wird der Energie-Manager darüber informiert, dass ein Gerät beim Starten einen Stromstrom benötigt.
WdfDeviceInitSetPowerInrush(DeviceInit);
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
KMDF-Mindestversion | 1.0 |
Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
IRQL | <= DISPATCH_LEVEL |
DDI-Complianceregeln | ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |