Funzione NetPowerOffloadListGetElement (netpoweroffloadlist.h)

  • Articolo

La funzione NetPowerOffloadListGetElement ottiene un offload del protocollo a basso consumo da un elenco di offload a una scheda net.

Sintassi

NETPOWEROFFLOAD NetPowerOffloadListGetElement(
  [_In_] const NET_POWER_OFFLOAD_LIST *List,
  [_In_] SIZE_T                       Index
);

Parametri

[_In_] List

Puntatore a una struttura NET_POWER_OFFLOAD_LIST allocata dal driver e inizializzata.

[_In_] Index

Indice in base zero nell'elenco per l'oggetto NETPOWEROFFLOAD di destinazione. Questa funzione deve essere minore del valore restituito da NetPowerOffloadListGetCount.

Valore restituito

Restituisce l'oggetto NETPOWEROFFLOAD, che rappresenta l'offload del protocollo a basso consumo, in corrispondenza dell'indice specificato nell'elenco.

Commenti

Chiamare NetPowerOffloadListGetCount per ottenere il numero di offload del protocollo a basso consumo prima di chiamare questa funzione.

Il driver client deve chiamare netPowerOffloadListGetElement solo 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 degli errori di sistema.

Per un esempio di codice relativo all'uso di oggetti NETPOWEROFFLOAD, vedere Configurazione del risparmio energia.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 2004
Piattaforma di destinazione Universale
Intestazione netpoweroffloadlist.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

Vedi anche

Configurazione del risparmio energia

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount