Função WifiWakeSourceListGetElement (wificxwakesourcelist.h)

Artigo
02/07/2025

A função WifiWakeSourceListGetElement obtém uma fonte de ativação da lista de fontes de ativação para um adaptador de rede WiFiCx.

Sintaxe

WIFIWAKESOURCE WifiWakeSourceListGetElement(
  const WIFI_WAKE_SOURCE_LIST *List,
  SIZE_T                      Index
);

Parâmetros

List

[em] Um identificador para uma estrutura de WIFI_WAKE_SOURCE_LIST alocada por driver e inicializada.

Index

[em] O índice baseado em zero na lista do objeto WIFIWAKESOURCE de destino. Essa função deve ser menor que o valor retornado por WifiWakeSourceListGetCount.

Valor de retorno

Retorna o objeto WIFIWAKESOURCE, que representa a fonte de ativação, no índice especificado na lista.

Observações

Chame WifiWakeSourceListGetCount para obter o número de fontes de ativação antes de chamar essa função.

O driver cliente deve chamar apenas WifiWakeSourceListGetElement durante uma transição de energia, normalmente de sua função de retorno de chamada EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0ou EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE. Caso contrário, a chamada resultará em uma verificação de bugs do sistema.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 11
servidor com suporte mínimo	Windows Server 2022
cabeçalho	wificxwakesourcelist.h
IRQL	PASSIVE_LEVEL

Consulte também

WIFI_WAKE_SOURCE_LIST

WifiWakeSourceListGetCount

Partilhar via