Auf Englisch lesen

Freigeben über


NetWakeSourceListGetElement-Funktion (netwakesourcelist.h)

Die NetWakeSourceListGetElement--Funktion ruft eine Wake-Quelle aus der Liste der Wakequellen für einen Netzadapter ab.

Syntax

NETWAKESOURCE NetWakeSourceListGetElement(
  [_In_] const NET_WAKE_SOURCE_LIST *List,
  [_In_] SIZE_T                     Index
);

Parameter

[_In_] List

Ein Handle für eine vom Treiber zugewiesene und initialisierte NET_WAKE_SOURCE_LIST Struktur.

[_In_] Index

Der nullbasierte Index in der Liste für das NetWAKESOURCE-Zielobjekt. Diese Funktion muss kleiner als der von NetWakeSourceListGetCountzurückgegebene Wert sein.

Rückgabewert

Gibt das NETWAKESOURCE -Objekt, das die Wake-Quelle darstellt, am angegebenen Index in der Liste zurück.

Bemerkungen

Rufen Sie NetWakeSourceListGetCount- auf, um die Anzahl der Wake-Quellen abzurufen, bevor Sie diese Funktion aufrufen.

Der Clienttreiber darf nur NetWakeSourceListGetElement- während eines Stromübergangs aufrufen, in der Regel von der EVT_WDF_DEVICE_ARM_WAKE_FROM_SX-, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0- oder EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE Rückruffunktion. Andernfalls führt der Aufruf zu einer Systemfehlerüberprüfung.

Ein Codebeispiel zum Arbeiten mit NETWAKESOURCE-Objekten finden Sie unter Konfigurieren der Energieverwaltung.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10, Version 2004
Zielplattform- Universal
Mindest-UMDF-Version 2.33
Header- netwakesourcelist.h (include netadaptercx.h)
Library netadaptercxstub.lib
IRQL- PASSIVE_LEVEL

Siehe auch

Konfigurieren von Energieverwaltungs-

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount-