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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. 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, den SetPowerPolicy in Value bereitstellt.
[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 |
|---|---|
|
SetPowerPolicy hat die WinUsb-Energierichtlinie erfolgreich festgelegt. |
|
Bei SetPowerPolicy ist ein Zuordnungsfehler aufgetreten. |
|
Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat. |
Hinweise
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 Parameter PolicyType und Value übergeben kann, finden Sie in der funktion WinUsb_SetPowerPolicy .
Weitere Informationen zum Leistungsverhalten von WinUSB finden Sie unter WinUSB-Energieverwaltung.
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 |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfusb.h (schließen Sie Wudfusb.h ein) |
| DLL | WUDFx.dll |