Condividi tramite


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 info, vedi Introduzione con UMDF.]

Il metodo SetPowerPolicy imposta i criteri di alimentazione 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

Dimensione, in byte, del buffer fornito da SetPowerPolicy in Value.

[in] Value

Puntatore al buffer contenente i criteri di alimentazione WinUsb.

Valore restituito

SetPowerPolicy restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_OK

ImpostarePowerPolicy correttamente impostare i criteri di alimentazione WinUsb.

E_OUTOFMEMORY

SetPowerPolicy ha rilevato un errore di allocazione.

Codice di errore definito in Winerror.h
Questo valore corrisponde al codice di errore restituito dall'API WinUsb.

Commenti

I criteri di risparmio energia controllano 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 della potenza di WinUSB, vedere Gestione alimentazione WinUSB.

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

Requisiti

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.5
Intestazione wudfusb.h (include Wudfusb.h)
DLL WUDFx.dll

Vedi anche

IWDFUsbTargetDevice

IWDFUsbTargetDevice::RetrievePowerPolicy

WinUsb_SetPowerPolicy