NET_POWER_OFFLOAD_LIST struttura (netpoweroffloadlist.h)

Articolo
02/26/2024

La struttura NET_POWER_OFFLOAD_LIST rappresenta un elenco di offload del protocollo a bassa alimentazione in una scheda net.

Sintassi

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_POWER_OFFLOAD_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_POWER_OFFLOAD_LIST_INIT per inizializzare questa struttura, quindi chiamare NetDeviceGetPowerOffloadList per ottenere l'elenco di offload a bassa alimentazione in questa scheda net. Dopo aver ottenuto l'elenco, chiamare NetPowerOffloadListGetCount con questa struttura per ottenere il numero di oggetti NETPOWEROFFLOAD che rappresentano gli offload, quindi eseguire il ciclo sugli oggetti e chiamare NetPowerOffloadListGetElement per recuperare ognuno di essi. Dopo aver ottenuto un oggetto NETPOWEROFFLOAD, chiamare NetPowerOffloadGetType per ottenere il tipo di offload in modo da poter chiamare la funzione appropriata per ottenere i parametri di offload.

Il driver client deve chiamare solo funzioni correlate all'offload di alimentazione 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_POWER_OFFLOAD 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 NETPOWEROFFLOAD, vedere Configurazione della gestione energia.