Compartilhar via


Função NetWakeSourceListGetCount (netwakesourcelist.h)

A função NetWakeSourceListGetCount obtém o número de fontes de ativação para um adaptador de rede.

Sintaxe

SIZE_T NetWakeSourceListGetCount(
  [_In_] const NET_WAKE_SOURCE_LIST *List
);

Parâmetros

[_In_] List

Um ponteiro para uma estrutura de NET_WAKE_SOURCE_LIST alocada e inicializada pelo driver.

Retornar valor

Retorna o número de fontes de ativação para esse adaptador de rede.

Comentários

Chame NET_WAKE_SOURCE_LIST_INIT para inicializar a estrutura NET_WAKE_SOURCE_LIST e, em seguida, chame NetDeviceGetWakeSourceList para recuperar a lista de fontes de ativação. Depois de obter a lista, chame essa função para determinar quantas fontes de ativação existem para esse adaptador de rede.

O driver cliente só deve chamar NetWakeSourceListGetCount 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_S0 ou EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE . Caso contrário, a chamada resultará em uma verificação de bugs do sistema.

Para obter um exemplo de código de como trabalhar com objetos NETWAKESOURCE, consulte Configurando o gerenciamento de energia.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 2004
Plataforma de Destino Universal
Versão mínima do UMDF 2.33
Cabeçalho netwakesourcelist.h (inclua netadaptercx.h)
Biblioteca netadaptercxstub.lib
IRQL PASSIVE_LEVEL

Confira também

Configurando o gerenciamento de energia

NET_WAKE_SOURCE_LIST_INIT

NET_WAKE_SOURCE_LIST

NetDeviceGetWakeSourceList