Funzione NetPowerOffloadListGetElement (netpoweroffloadlist.h)
La funzione netPowerOffloadListGetElement ottiene un offload di 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 di driver allocata e inizializzata NET_POWER_OFFLOAD_LIST.
[_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.
Osservazioni
Chiamare NetPowerOffloadListGetCount per ottenere il numero di offload del protocollo a basso consumo prima di chiamare questa funzione.
Il driver client deve chiamare solo NetPowerOffloadListGetElement durante una transizione di alimentazione, in genere dalla relativa EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0o EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD funzione di callback. In caso contrario, la chiamata genera un controllo errori di sistema.
Per un esempio di codice relativo all'uso di oggetti NETPOWEROFFLOAD, vedere Configurazione del risparmio energia.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 2004 |
| piattaforma di destinazione | Universale |
| versione minima di UMDF | 2.33 |
| intestazione | netpoweroffloadlist.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Vedere anche
Configurazione dell' di risparmio energia