Función NetWakeSourceListGetElement (netwakesourcelist.h)

  • Artículo

La función NetWakeSourceListGetElement obtiene un origen de reactivación de la lista de orígenes de reactivación para un adaptador neto.

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 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
Encabezado netwakesourcelist.h (include netadaptercx.h)
Library netadaptercxstub.lib
IRQL PASSIVE_LEVEL

Consulte también

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

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount