Función NetWakeSourceListGetElement (netwakesourcelist.h)
La función NetWakeSourceListGetElement obtiene un origen de reactivación de la lista de orígenes de reactivación para un adaptador net.
Sintaxis
NETWAKESOURCE NetWakeSourceListGetElement(
[_In_] const NET_WAKE_SOURCE_LIST *List,
[_In_] SIZE_T Index
);
Parámetros
[_In_] List
Identificador de una estructura de NET_WAKE_SOURCE_LIST asignada por el controlador e inicializada.
[_In_] Index
Índice de base cero de la lista para el objeto NETWAKESOURCE de destino. Esta función debe ser menor que el valor devuelto por NetWakeSourceListGetCount.
Valor devuelto
Devuelve el objeto NETWAKESOURCE, que representa el origen de reactivación, en el índice especificado de la lista.
Comentarios
Llame a NetWakeSourceListGetCount para obtener el número de orígenes de reactivación antes de llamar a esta función.
El controlador de cliente solo debe llamar a NetWakeSourceListGetElement 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.
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 | netwakesourcelist.h (include netadaptercx.h) |
| Library | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |