Método IWDFUsbTargetDevice::SetPowerPolicy (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 SetPowerPolicy establece la directiva de energía winUsb.
Sintaxis
HRESULT SetPowerPolicy(
[in] ULONG PolicyType,
[in] ULONG ValueLength,
[in] PVOID Value
);
Parámetros
[in] PolicyType
El tipo de directiva de energía de WinUsb que establece el controlador UMDF.
[in] ValueLength
Tamaño, en bytes, del búfer que Proporciona SetPowerPolicy en Value.
[in] Value
Puntero al búfer que contiene la directiva de energía winUsb.
Valor devuelto
SetPowerPolicy devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
SetPowerPolicy estableció correctamente la directiva de energía winUsb. |
|
SetPowerPolicy encontró un error de asignación. |
|
Este valor corresponde al código de error que devolvió la API 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 valores y tipos de directiva válidos que un controlador UMDF puede pasar para los parámetros PolicyType y Value , consulte la función WinUsb_SetPowerPolicy .
Para obtener más información sobre el comportamiento de energía de WinUSB, consulta Administración de energía de WinUSB.
El método SetPowerPolicy 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 |