Método IWDFUsbTargetDevice::RetrievePowerPolicy (wudfusb.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
El método RetrievePowerPolicy recupera una directiva de energía winUsb.
Sintaxis
HRESULT RetrievePowerPolicy(
[in] ULONG PolicyType,
[in, out] ULONG *ValueLength,
[out] PVOID Value
);
Parámetros
[in] PolicyType
El tipo de directiva de energía de WinUsb que solicita el controlador UMDF.
[in, out] ValueLength
Puntero a una variable que, en la entrada, contiene el tamaño, en bytes, del búfer que RetrievePowerPolicy proporciona en Value. En la salida, este parámetro contiene el tamaño que retrievePowerPolicy requiere para Value.
[out] Value
Puntero que recibe el búfer que contiene la directiva de energía de WinUsb.
Valor devuelto
RetrievePowerPolicy devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
RetrievePowerPolicy recuperó correctamente la directiva de energía winUsb. |
|
RetrievePowerPolicy encontró un error de asignación. |
|
Este valor corresponde al código de error que devolvió la API de WinUsb. |
Observaciones
La directiva de energía controla la administración de energía que realiza WinUsb para el dispositivo.
Para obtener información sobre los tipos de directiva válidos que un controlador UMDF puede pasar para el parámetro PolicyType y los valores que devuelve el marco, consulte la función WinUsb_GetPowerPolicy.
Para obtener más información sobre el comportamiento de energía de WinUSB, consulte Administración de energía de WinUSB.
El método RetrievePowerPolicy genera una solicitud UMDF y envía sincrónicamente la solicitud al destino de E/S.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfusb.h (incluya Wudfusb.h) |
| DLL de | WUDFx.dll |