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
S_OK	RetrievePowerPolicy hat die WinUsb-Energierichtlinie erfolgreich abgerufen.
E_OUTOFMEMORY	Bei RetrievePowerPolicy ist ein Zuordnungsfehler aufgetreten.
Ein Fehlercode, der in "Winerror.h" definiert ist	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

Weitere Informationen

IWDFUsbTargetDevice

IWDFUsbTargetDevice::SetPowerPolicy

WinUsb_GetPowerPolicy