Metodo IWDFUsbTargetDevice::RetrievePowerPolicy (wudfusb.h)

Articolo
08/08/2023

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]

Il metodo RetrievePowerPolicy recupera un criterio di alimentazione WinUsb.

Sintassi

HRESULT RetrievePowerPolicy(
  [in]      ULONG PolicyType,
  [in, out] ULONG *ValueLength,
  [out]     PVOID Value
);

Parametri

[in] PolicyType

Tipo di criterio di alimentazione WinUsb richiesto dal driver UMDF.

[in, out] ValueLength

Puntatore a una variabile che, nell'input, contiene le dimensioni, in byte, del buffer fornito da RetrievePowerPolicy in Valore. In output, questo parametro contiene le dimensioni necessarie perRetrievePowerPolicy.

[out] Value

Puntatore che riceve il buffer che contiene i criteri di alimentazione WinUsb.

Valore restituito

RetrievePowerPolicy restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	RecuperaPowerPolicy ha recuperato correttamente i criteri di alimentazione WinUsb.
E_OUTOFMEMORY	RecuperaPowerPolicy 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 alimentazione controllano la gestione energia eseguita da WinUsb per il dispositivo.

Per informazioni sui tipi di criteri validi che un driver UMDF può passare per il parametro PolicyType e i valori restituiti dal framework, vedere la funzione WinUsb_GetPowerPolicy .

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

Il metodo RetrievePowerPolicy genera una richiesta UMDF e invia in modo sincrono la richiesta alla destinazione 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::SetPowerPolicy

WinUsb_GetPowerPolicy

Condividi tramite