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 potencia, en el índice especificado de la lista.

Comentarios

Llame a NetPowerOffloadListGetCount para obtener el número de descargas de protocolo de poca energía 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
Encabezado	netpoweroffloadlist.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Consulte también

Configuración de la administración de energía

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount