estructura NET_WAKE_SOURCE_LIST (netwakesourcelist.h)

Artículo
08/07/2023

La estructura NET_WAKE_SOURCE_LIST representa una lista de orígenes wake-on-LAN (WoL) para un adaptador neto.

Sintaxis

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

Miembros

Size

Tamaño de esta estructura, en bytes.

Reserved[4]

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

Comentarios

Llame a NET_WAKE_SOURCE_LIST_INIT para inicializar esta estructura y, a continuación, llame a NetDeviceGetWakeSourceList para obtener la lista de orígenes de reactivación de este adaptador de red. Después de obtener la lista, llame a NetWakeSourceListGetCount con esta estructura para obtener el número de objetos NETWAKESOURCE que representa los orígenes de reactivación y, a continuación, recorra en bucle los objetos y llame a NetWakeSourceListGetElement para recuperar cada uno. Una vez que haya obtenido un objeto NETWAKESOURCE, llame a NetWakeSourceGetType para obtener el tipo de ese origen de reactivación para poder llamar a la función adecuada para obtener los parámetros del origen de reactivación.

El controlador cliente solo debe llamar a funciones relacionadas con el origen de reactivación 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_WAKE_SOURCE 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 NETWAKESOURCE, consulte Configuración de la administración de energía.