IWDFUsbTargetDevice::RetrievePowerPolicy-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 RetrievePowerPolicy-Methode ruft eine WinUsb-Energierichtlinie ab.
Syntax
HRESULT RetrievePowerPolicy(
[in] ULONG PolicyType,
[in, out] ULONG *ValueLength,
[out] PVOID Value
);
Parameter
[in] PolicyType
Der Typ der WinUsb-Energierichtlinie, die der UMDF-Treiber anfordert.
[in, out] ValueLength
Ein Zeiger auf eine Variable, die bei der Eingabe die Größe des Puffers in Byte enthält, den RetrievePowerPolicy in Value bereitstellt. In der Ausgabe enthält dieser Parameter die Größe, die RetrievePowerPolicy für Value benötigt.
[out] Value
Ein Zeiger, der den Puffer empfängt, der die WinUsb-Energierichtlinie enthält.
Rückgabewert
RetrievePowerPolicy gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
RetrievePowerPolicy hat die WinUsb-Energierichtlinie erfolgreich abgerufen. |
|
Bei RetrievePowerPolicy 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, die ein UMDF-Treiber für den PolicyType-Parameter und die vom Framework zurückgegebenen Werte übergeben kann, finden Sie in der funktion WinUsb_GetPowerPolicy .
Weitere Informationen zum Leistungsverhalten von WinUSB finden Sie unter WinUSB-Energieverwaltung.
Die RetrievePowerPolicy-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 |