Freigeben über


IWDFUsbTargetDevice::SetPowerPolicy-Methode (wudfusb.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]

Die SetPowerPolicy--Methode legt die WinUsb-Energierichtlinie fest.

Syntax

HRESULT SetPowerPolicy(
  [in] ULONG PolicyType,
  [in] ULONG ValueLength,
  [in] PVOID Value
);

Parameter

[in] PolicyType

Der Typ der WinUsb-Energierichtlinie, die der UMDF-Treiber festlegt.

[in] ValueLength

Die Größe des Puffers in Byte, der SetPowerPolicy in Value.

[in] Value

Ein Zeiger auf den Puffer, der die WinUsb-Energierichtlinie enthält.

Rückgabewert

SetPowerPolicy gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK

SetPowerPolicy die WinUsb-Energierichtlinie erfolgreich festlegen.

E_OUTOFMEMORY

SetPowerPolicy ein Zuordnungsfehler aufgetreten.

Ein Fehlercode, der in winerror.h definiert ist
Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat.

Bemerkungen

Die Energierichtlinie steuert die Energieverwaltung, die WinUsb für das Gerät ausführt.

Informationen zu gültigen Richtlinientypen und Werten, die ein UMDF-Treiber für die PolicyType- und Parameter "Value" übergeben kann, finden Sie in der WinUsb_SetPowerPolicy-Funktion.

Weitere Informationen zum Leistungsverhalten von WinUSB finden Sie unter WinUSB Power Management.

Die SetPowerPolicy-Methode generiert eine UMDF-Anforderung und sendet die Anforderung synchron an das E/A-Ziel.

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform- Desktop
Mindest-UMDF-Version 1.5
Header- wudfusb.h (include Wudfusb.h)
DLL- WUDFx.dll

Siehe auch

IWDFUsbTargetDevice

IWDFUsbTargetDevice::RetrievePowerPolicy

WinUsb_SetPowerPolicy