Funzione NetWakeSourceListGetElement (netwakesourcelist.h)

La funzione NetWakeSourceListGetElement ottiene un'origine di riattivazione dall'elenco delle origini di riattivazione per una scheda net.

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 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.

Commenti

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_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.

Requisiti

Vedi anche

Configurazione del risparmio energia

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount