NetPowerOffloadListGetElement 関数 (netpoweroffloadlist.h)
NetPowerOffloadListGetElement 関数は、ネット アダプターへのオフロードの一覧から低電力プロトコル オフロードを取得します。
構文
NETPOWEROFFLOAD NetPowerOffloadListGetElement(
[_In_] const NET_POWER_OFFLOAD_LIST *List,
[_In_] SIZE_T Index
);
パラメーター
[_In_] List
ドライバーによって割り当てられ、初期化された NET_POWER_OFFLOAD_LIST 構造体へのポインター。
[_In_] Index
ターゲット NETPOWEROFFLOAD オブジェクトのリスト内の 0 から始まるインデックス。 この関数は、 NetPowerOffloadListGetCount によって返される値より小さくする必要があります。
戻り値
一覧内の指定したインデックス位置にある低電力プロトコル オフロードを表す NETPOWEROFFLOAD オブジェクトを返します。
注釈
NetPowerOffloadListGetCount を呼び出して、この関数を呼び出す前に低電力プロトコル オフロードの数を取得します。
クライアント ドライバーは、電源切り替え中にのみ NetPowerOffloadListGetElement を呼び出す必要があります。通常は、 そのEVT_WDF_DEVICE_ARM_WAKE_FROM_SX、 EVT_WDF_DEVICE_ARM_WAKE_FROM_S0、または コールバック関数からEVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD 。 それ以外の場合、呼び出しによってシステムバグチェックが行われます。
NETPOWEROFFLOAD オブジェクトを操作するコード サンプルについては、「 電源管理の構成」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 バージョン 2004 |
| 対象プラットフォーム | ユニバーサル |
| 最小 UMDF バージョン | 2.33 |
| Header | netpoweroffloadlist.h (netadaptercx.h を含む) |
| IRQL | PASSIVE_LEVEL |