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 |
|---|---|
|
ImpostarePowerPolicy correttamente impostare i criteri di alimentazione WinUsb. |
|
SetPowerPolicy ha rilevato un errore di allocazione. |
|
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 |