Metodo IWDFUsbTargetDevice::SetPowerPolicy (wudfusb.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]

Il metodo SetPowerPolicy imposta i criteri di risparmio energia WinUsb.

Sintassi

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

Parametri

[in] PolicyType

Tipo di criteri di alimentazione WinUsb impostati dal driver UMDF.

[in] ValueLength

Dimensioni, in byte, del buffer fornito SetPowerPolicy in Valore.

[in] Value

Puntatore al buffer che contiene i criteri di alimentazione WinUsb.

Valore restituito

SetPowerPolicy restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	SetPowerPolicy impostare correttamente i criteri di risparmio energia WinUsb.
E_OUTOFMEMORY	SetPowerPolicy rilevato un errore di allocazione.
Codice di errore definito in Winerror.h	Questo valore corrisponde al codice di errore restituito dall'API WinUsb.

Osservazioni

Power policy controlla il risparmio energia eseguito da WinUsb per il dispositivo.

Per informazioni sui tipi di criteri e i valori validi che un driver UMDF può passare per i parametri PolicyType e Value, vedere la funzione WinUsb_SetPowerPolicy.

Per altre informazioni sul comportamento di alimentazione di WinUSB, vedere Gestione energia WinUSB.

Il metodo SetPowerPolicy genera una richiesta UMDF e invia in modo sincrono la richiesta alla destinazione di I/O.

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.5
intestazione	wudfusb.h (include Wudfusb.h)
dll	WUDFx.dll

Vedere anche

IWDFUsbTargetDevice

IWDFUsbTargetDevice::RetrievePowerPolicy

WinUsb_SetPowerPolicy