Funzione NetWakeSourceListGetElement (netwakesourcelist.h)
La funzione NetWakeSourceListGetElement ottiene un'origine di riattivazione dall'elenco di origini di riattivazione per un net adapter.
Sintassi
NETWAKESOURCE NetWakeSourceListGetElement(
[_In_] const NET_WAKE_SOURCE_LIST *List,
[_In_] SIZE_T Index
);
Parametri
[_In_] List
Handle per una struttura di NET_WAKE_SOURCE_LIST allocata e inizializzata del driver.
[_In_] Index
Indice in base zero nell'elenco per l'oggetto NETWAKESOURCE di destinazione. Questa funzione deve essere minore del valore restituito da NetWakeSourceListGetCount.
Valore restituito
Restituisce l'oggetto NETWAKESOURCE, che rappresenta l'origine di riattivazione, in corrispondenza dell'indice specificato nell'elenco.
Osservazioni
Chiamare NetWakeSourceListGetCount per ottenere il numero di origini di riattivazione prima di chiamare questa funzione.
Il driver client deve chiamare solo NetWakeSourceListGetElement durante una transizione di alimentazione, in genere dal relativo EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0o EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE funzione di callback. In caso contrario, la chiamata genera un controllo errori di sistema.
Per un esempio di codice relativo all'uso di oggetti NETWAKESOURCE, 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 | netwakesourcelist.h (include netadaptercx.h) |
| libreria | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |
Vedere anche
Configurazione dell' di risparmio energia