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 controladores UMDF nuevos deben escribirse con 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 con 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
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 valores siguientes:
| 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. |
Comentarios
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, vea 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 | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1.5 |
| Encabezado | wudfusb.h (incluya Wudfusb.h) |
| Archivo DLL | WUDFx.dll |