NetPowerOffloadListGetElement 関数 (netpoweroffloadlist.h)

  • [アーティクル]

NetPowerOffloadListGetElement 関数は、net アダプターへのオフロードの一覧から低電力プロトコル オフロードを取得します。

構文

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
対象プラットフォーム ユニバーサル
Header netpoweroffloadlist.h (netadaptercx.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

電源管理の構成

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount