WifiPowerOffloadListGetElement 関数 (wificxpoweroffloadlist.h)

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

構文

WIFIPOWEROFFLOAD WifiPowerOffloadListGetElement(
  const WIFI_POWER_OFFLOAD_LIST *List,
  SIZE_T                        Index
);

List

[入力]ドライバーによって割り当てられ、 初期化されたWIFI_POWER_OFFLOAD_LIST 構造体へのポインター。

Index

[入力]ターゲット WIFIPOWEROFFLOAD オブジェクトのリスト内の 0 から始まるインデックス。この関数は、 WifiPowerOffloadListGetCount によって返される値より小さくする必要があります。

一覧内の指定したインデックス位置にある低電力プロトコルオフロードを表す WIFIPOWEROFFLOAD オブジェクトを返します。

WifiPowerOffloadListGetCount を呼び出して、この関数を呼び出す前に低電力プロトコルオフロードの数を取得します。

クライアントドライバーは、電源切り替え中にのみ WifiPowerOffloadListGetElement を呼び出す必要があります。通常は、 EVT_WDF_DEVICE_ARM_WAKE_FROM_SX、 EVT_WDF_DEVICE_ARM_WAKE_FROM_S0、 またはコールバック関数からEVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD 。それ以外の場合、呼び出しによってシステムバグチェックが行われます。