NetWakeSourceListGetElement-Funktion (netwakesourcelist.h)

Die NetWakeSourceListGetElement-Funktion ruft eine Aktivierungsquelle aus der Liste der Aktivierungsquellen 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 NetWakeSourceListGetCount zurückgegebene Wert sein.

Rückgabewert

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

Hinweise

Rufen Sie NetWakeSourceListGetCount auf, um die Anzahl der Aktivierungsquellen abzurufen, bevor Sie diese Funktion aufrufen.

Der Clienttreiber darf NetWakeSourceListGetElement nur während eines Energieübergangs aufrufen, in der Regel über seine 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
Unterstützte Mindestversion (Client)	Windows 10, Version 2004
Zielplattform	Universell
Header	netwakesourcelist.h (include netadaptercx.h)
Bibliothek	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

Konfigurieren der Energieverwaltung

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount