Función NetPowerOffloadListGetElement (netpoweroffloadlist.h)
La función NetPowerOffloadListGetElement obtiene una descarga de protocolo de bajo consumo de una lista de descargas en un adaptador neto.
Sintaxis
NETPOWEROFFLOAD NetPowerOffloadListGetElement(
[_In_] const NET_POWER_OFFLOAD_LIST *List,
[_In_] SIZE_T Index
);
Parámetros
[_In_] List
Puntero a una estructura de NET_POWER_OFFLOAD_LIST asignada por el controlador e inicializada.
[_In_] Index
Índice de base cero de la lista para el objeto NETPOWEROFFLOAD de destino. Esta función debe ser menor que el valor devuelto por NetPowerOffloadListGetCount.
Valor devuelto
Devuelve el objeto NETPOWEROFFLOAD, que representa la descarga del protocolo de baja energía, en el índice especificado de la lista.
Comentarios
Llame a NetPowerOffloadListGetCount para obtener el número de descargas de protocolo de bajo consumo antes de llamar a esta función.
El controlador cliente solo debe llamar a NetPowerOffloadListGetElement durante una transición de energía, normalmente desde su EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 o EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD función de devolución de llamada. De lo contrario, la llamada da como resultado una comprobación de errores del sistema.
Para obtener un ejemplo de código de cómo trabajar con objetos NETPOWEROFFLOAD, consulte Configuración de la administración de energía.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 2004 |
| Plataforma de destino | Universal |
| Versión mínima de UMDF | 2,33 |
| Encabezado | netpoweroffloadlist.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |