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.

Observaciones

Llame a NetWakeSourceListGetCount para obtener el número de orígenes de reactivación antes de llamar a esta función.

El controlador 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_S0o EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE función de devolución de llamada. De lo contrario, la llamada produce 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

Consulte también

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

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount