NET_WAKE_SOURCE_LIST struttura (netwakesourcelist.h)

Articolo
02/26/2024

La struttura NET_WAKE_SOURCE_LIST rappresenta un elenco di origini wake-on-LAN (WoL) per una scheda net.

Sintassi

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

Members

Size

Dimensioni di questa struttura, in byte.

Reserved[4]

Riservato. I driver client non devono leggere o scrivere direttamente in questo valore.

Commenti

Chiamare NET_WAKE_SOURCE_LIST_INIT per inizializzare questa struttura, quindi chiamare NetDeviceGetWakeSourceList per ottenere l'elenco delle origini di riattivazione da questa scheda net. Dopo aver ottenuto l'elenco, chiamare NetWakeSourceListGetCount con questa struttura per ottenere il numero di oggetti NETWAKESOURCE che rappresentano le origini di riattivazione, quindi eseguire il ciclo sugli oggetti e chiamare NetWakeSourceListGetElement per recuperare ognuno di essi. Dopo aver ottenuto un oggetto NETWAKESOURCE, chiamare NetWakeSourceGetType per ottenere il tipo di origine di riattivazione in modo da poter chiamare la funzione appropriata per ottenere i parametri dell'origine di riattivazione.

Il driver client deve chiamare solo funzioni correlate all'origine durante una transizione di alimentazione, in genere dal relativo EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 o EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE funzione di callback. In caso contrario, la chiamata genera un controllo di bug di sistema.

Per un esempio di codice di uso con gli oggetti NETWAKESOURCE, vedere Configurazione della gestione energia.