estructura NET_POWER_OFFLOAD_LIST (netpoweroffloadlist.h)

Artículo
08/07/2023

La estructura NET_POWER_OFFLOAD_LIST representa una lista de descargas de protocolos de baja energía en un adaptador neto.

Sintaxis

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_POWER_OFFLOAD_LIST;

Miembros

Size

Tamaño de esta estructura, en bytes.

Reserved[4]

Reservado. Los controladores de cliente no deben leer o escribir directamente en este valor.

Comentarios

Llame a NET_POWER_OFFLOAD_LIST_INIT para inicializar esta estructura y, a continuación, llame a NetDeviceGetPowerOffloadList para obtener la lista de descargas de energía baja en este adaptador neto. Después de obtener la lista, llame a NetPowerOffloadListGetCount con esta estructura para obtener el número de objetos NETPOWEROFFLOAD que representa las descargas y, a continuación, recorra los objetos y llame a NetPowerOffloadListGetElement para recuperar cada uno. Una vez que haya obtenido un objeto NETPOWEROFFLOAD, llame a NetPowerOffloadGetType para obtener el tipo de esa descarga para poder llamar a la función adecuada para obtener los parámetros de la descarga.

El controlador cliente solo debe llamar a funciones relacionadas con la descarga de energía 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.