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)

Weitere Informationen

EvtDriverDeviceAdd

WdfDeviceCreate